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Dilwyn Jones 


This month we take the plunge into assem- 
bly language programming with a brand 
new series by Norman Dunbar. Many rea- 
ders have asked for such a course, sO we 
offer a big thank you to Norman for under- 
taking such a massive task. This will be a 
major series, hopefully, so | hope you enjoy 
it and find it useful. 

It's fairly quiet on the QL front this month, 
as the rather short news pages will show. 
No doubt there are people out there bea- 
vering away as ever! So sit back and dr 
gest the useful series from our regular 
contributors like Mark Knight, Nasta (the 
cartoon wasn't my idea, honest!), Roy 
Wood and Stuart Honeyball. Thanks, lads, 
where would | be without you? 

We are in a period of consolidation now. 
Work continues on the Goldfire, Colour 
Drivers, QemuLator for PC and on deve- 
lopment of the other emulators. The Amiga 
QDOS emulator has acquired the ability to 
read WIN hard disk files, QPC may yet get 
the ability to read DOS hard disk files {as 
well as the existing QXLWIN). The Qubide 
may yet get the ability to handle ATAPIIDE 
devices like ZIP drives and just possibly 
the LS-120 super-floppies. Nasta has been 
making noises on the QL Users Mailing List 
about a new soundcard, a SCSI interface is 
being threatened and several people on 
that list have been making detailed lists of 
how file handling and other aspects of QL 


Clipart for a chruch newsletter for example, 
George Morris is now offering modestly 
priced religious software to the QL scene. 
More details elsewhere in the magazine. 
Nice to see that there is still room for this 
sort of venture, | hope you'll support 
George in his venture. Our best wishes to 
him. 

There are again a number of articles held 
over to the next issue, because we ran out 
of space for them all If your article hasn't 
been printed yet, bear with us! 

Last issue, we promised to print a fix to 
allow the use of a Prospero Pro-Pascal 
EPROM Cartridge file to be run from RAM. 
Unfortunately, after we printed that, we rea- 
lised that it was a copy-protection mecha- 
nism which prevented Its use from RAM, 
and certain copyright issues pertaining to 
the software license came to light which 
mean we cannot publish David Bunbury’s 
article, as we have not received permission 
from the publisher to print the ‘fix’. 

We also offered a small prize for the best 
Hints and Tips short listing. We had a dis- 
appointing response to this - only a small 
handful of entries were received, so we'll 
ask you again to enter this competition 
and hopefully publish several entries and 
award the prize in the next issue. My thanks 
to those who have already sent in the 
small number of admittedly quite ingenious 
listings. 


development should go in the future. =— 
And Stella? A new system from Tony 
Tebby? Well, Arnould Nazarian gave 
details of this operating system core 
on the Mailing List, and Thierry 
Godefroy has kindly placed the exten- 
sive documentation on his Web site if 
youre interested. We've seen a lot of 
this type of talk and hype before and 
it's come to nothing. But | detect a 
different determination this time, that 
though this may all take a long time, 
the groundwork is being prepared for 
major enhancement in the future once 
the current crop of offerings become 
reality. 

Welcome to a new software supplier - 
whether you want various Bible ver- 
sions, or specialist software for Bible 
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RomDisq Driver | 
Upgrade News | 


A new RomDisq Driver | 
(V212) is available on QBBS | 
014.42-828255 or my web page | 
http:/firshman.demon.co.uk | 

This is to correct a rare but | 
fatal bug when writing to Rom: | 
Disq. Typically if this occurred, | 
the QL would lock up while | 
writing to RomDisa, and then j 
there would be a corrupted | 
directory. Fortunately this has | 
happened to only a few users, | 
but it is a mandatory upgrade. It | 
is also available from me by | 
post - SAE and formatted disk. | 

We have made a minor | 
hardware change to the board | 
- also an essential upgrade. | 
Early boards had a small capa- | 
citor soldered direct to pins 1 | 
and 2 of the 8-way program: | 
ming socket for no capacitor | 
was fitted) This capacitor | 
should be between pin 2 and | 
the main board. Any RomDisq | 
not modified in this way must | 
be returned for upgrading | 
BEFORE V2.12 is installed. 


NEWS 


News from Jonathan 


Hudson 

Richard is working hard on 
integrating my IP device for uqlx 
(tcp_, udp_) into the uqlx main 
release; should be done by the 
time you publish, The QDOS 
version of Lynx on uqlx can now 
offer full internet access; though it 
only does this by leverage off the 
underlying Unix IP sub-system, so 
its a bit of cheat really. Maybe as 
we (the emulator) can do it 
(TCP/IP), we'll embarrass the real 
QL enthusiasts into doing some- 
thing? 


Colour Drivers 

Jean-Louis Dianoux of QLCF 
(QL Contact France) has written, 
asking us to point out that QLCF 
has decided to pay 17000 Francs 
(about 1700 pounds) to Tony 
Tebby towards cost of ‘licence of 
colour drivers’. Jean-Louis says 
he thought this would be of inter- 
est to Quanta and QL Today, so 
that Tony could be encouraged to 
work on the drivers. 


Religious Software 

George Morris writes to tell us 
about a range of religious soft- 
ware he is making available to all 
QL users with an interest in this 
subject. 

After spending some time 
gathering and preparing material, 
George Morris is now in a position 
to supply the following religious 
material, ranging from text docu- 
ments to complete programs. 
Anyone interested in this material 
should give George a phone call 
or send a letter to him to request 
an A4 sheet of details of any item 
in particular or a complete list of 
material available. The leaflets will 
include details of prices of the 
software on DD, HD or ED disks. 

While some religious material 
has previously been available for 
the QL user (e.g. the text of the 
King James Bible 's available from 
PD libraries), this is the first time 
that such a comprehensive collec- 
tion has been brought together. 
The list includes material of inte- 
rest to anyone from the layman to 
the professional student of reli 
gion. 

The material listed is mainly 
Christian in origin. However 
George also has a variety of 
material such as the Holy Koran, 
Buddhist material, Religions Of 
The World and so on. He believes 
that there is merit in offering 
these if only for the knowledge 
that they would give to Christians 
for dealing with people of other 
beliefs. All of these titles are aval 
lable now. 


- The King James Bible (Autho- 
rised version) 
- The New King James Bible 
- The New International Bible 
- The Concordant Literal New Tes- 
tament 
- Hebrew Old Testament {for Quill 
or Text 87 - displays as Hebrew 
text, for the student) 
- Hebrew Lexicon (Anglicised He- 
brew) 
- Koinee Greek New Testament 
(for Quill or Text 87 - displays the 
text as Koinee Greek) 
- Greek Lexicon (Anglicised Greek) 
- Bible Dictionary (with Anglicised 
Hebrew and Greek references) 
- New Testament Word Pictures 
(Anglicised Greek) 
- Bible Subject Index (based on 
words in King James Version Bible) 
- Bible Cross Reference 
- The Bible Companion {a major 
software work, covers many as- 
pects of Bible study and Christianity) 
- Hymnal Database 
- Critique of Bible Translations, by 
Dr. J. E. Russell 

Common Bible Myths _ (little 
known facts, very interesting 
reading) 
- Overview of KJV Bible..Con- 
struction etc. 


Three new Hebrew and two 
Greek fonts are available - some 
of the above works use Greek 
and Hebrew fonts 

In addition, the following works 
are currently in preparation: 

- Anglicised Greek New Testament 
- King James Bible (AV with JH. 
Strong’s Reference Numbers) 

- Young's Literal Bible Translation 

- JN.Darby'’s Old And New Testa- 
ment 

- Gil's Expositor 

- Thinkers’ Bible Notes. 

- Thompson Chain References 

- 60 (yes sixty) DD disks of Religr- 
ous Clipart for Line Design. 

- Short Essays on many Biblical 
subjects 


GREEK WORD Home Study Course. 
Suitable for understanding Greek holi- 
day phrases or for Bible study. 
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GREEK WORD studies and Bible 
subjects on Ad leaflets. 


For details, contact George 
Morris, 67 Wood Lane, Sutton 
Coldfield, West Midlands, B74 3LS, 
England. Telephone (+44) 
0121-353 8571 


Jochen Merz Software 

SMSQ/E exists in Version 2.89 
for all systems. It mainly contains 
bug-fixes, nothing major just small 
things which you usually don't 
notice. Updates are free, as usual. 
You can also now debug schedu- 
ler loop tasks with QMON and 
SMSQ/E. 

Sysmon (of QPAC 1} can now be 
placed outside the QL’s original 
windows. It also handles large 
areas of RAM, allocated in more 
than 64k of chunks (could previ- 
ously lead to memory corruption 
on systems with lots of RAM, e.g. 
a TT with 20MB. 

Now news about upcoming 
things: there has been the demand 
for a new debugger. Look at the 
cover page - the right screen 
dump shows you SMON. SMON 
can debug the system your'e 
working on, and it can debug 
another system via a serial port. 
The user interface will be the 
same, whether it is local or remote. 
SMON can handle all Motorola 68k 
and related instructions, PMMU, up 
to the 68060 etc. 

You can open and close various 
listing-windows, re-size them, dis- 
play things in various ways... it is a 
completely new design which was 
required to debug the (new) 
screen driver from a different ma- 
chine and to implement SMSQ/E 
on new hardware, e.g. Q40 and 
the Milan. 

It is not yet complete, the inline 
assembler is missing, for example. 

There are thoughts about ways 
to allow SMON to find the source 
of the current modules... this would 
be another very useful feature. 
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Help! The rumour (which some people think was started by me) that 
| Chas Dillons wife Sandy has died is not true. | most certainly did not 
| start the rumour though | must admit to having told quite a few people 
| once | was convinced of its veracity, including the editors of both 
| QUANTA and QL Today. Sandy is alive and well, though possibly a little 
i peturbed by rumours of her death. In fact somebody close to Sandy 
| died and in a bad case of Chinese whispers it was passed along from 
: person to person until by the time | heard (from more than one person 
| as it happens) it was Sandy who had died. 

| | did not pass it on until | heard it from somebody | regarded as a 
| reliable source. | will not name him, though rest assured | have made 
| my feelings known and will be informing Chas Dillon of his name so 
| Chas can make his own decision about whether to say (or indeed to 


| shout) anything, 


| Mark Knight 


QPC_ not 
SMSQ/E V2.89 now, it also sup- 
ports removable media (e.g. CD- 
ROMs, ZIP drives and allows you 
to change the QXLWIN filenames 
of the drives WINi_ through 
WIN8_ to be re-specified while the 
system Is running. 

Also, QPC can now LBYTES 
files from the harddisk directly to 
the screen. Updates are free (as 
usual), just add 3 International 
Reply COupons if you send the 
master disk. You can also 
download the current version from 
the J-M-S bulletin boards. 

SERNET should be available in a 
new version by the time you read 
this. You can now use SERNET via 
modem, ie. access a computer 
running SMSQ/E via modem and 
use the features known from 
Toolkit I's network. It is also 
possible to execute BASIC pro- 
grams on the remote machine, 
which means, you can do more or 
less everything you like (except 
for formatting the harddisk!). 


QBranch 


The price of Albin Hessler’s 
Easy Pointer package has been 


_ | would like to apologise to anybody who was unnecessarily upset by 
i this rumour, especially anybody who knows Sandy. 


only comes. with 


reduced. Parts 1 & 2 which contain 


the Menu and Sprite Generating 
tools, and have the SuperBasic 
Extensions will now be sold 
together for DM 99,- (oy Jochen 
Merz) or £33.00 (by Q Branch) and 
part 3 which has the ‘C’ library 
extensions for DM 49, or £16.00. 
In addition to this parts 1 & 2 will 
now include a free copy of the 
Pointer Environment Kit disk since 
this series of articles and example 
gives the best access to the 
package. 

Q Branch have reduced the 
price of the last remaining QXLs to 
£180.00 and the price of Cueshell 
to £30.00. 


| Apologies that there are 
/no screen dumps with the 
| DBEasy review. Bill Cable 
idid send us some 9 pin 
Epson style printer dumps, 
‘but as we were rather 
short of space we couldn't 
‘reproduce them — small 
enough at a good enough 
i quality to make it worth 
including them in the end. 
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Snake 


Dilwyn Jones 


This month, we start with a bit of entertainment brought to you in 
the form of a short BASIC listing. The original version of this 
game dates back to 1985, the listing has been updated July 


1997. 


Distribution status: Freeware (Le. 
you can give copies of it to any 
QL or compatible user) 

Tested on QPC Vi.15, QXL, QL 
with SMSQ/E, JM QL etc, should 
work on just about anything! 

This is the classic game of 
Snake. You have to guide the 
snake around the screen, eating 
the food points (shown by the 
numbers 1 to 9, or the ambiguous 
value '*') avoiding its own body 
and keeping it on the screen. As 
the snake grows, it gets more 
difficult to manage to move it 
without crashing into itself. 


100 REMark snake by Dilwyn Jones 


110 RANDOMISE 
120 MODE 8 : 
130 DIM board$(25,42) 
140 REPeat program 


Normally, you can see the 
number of units by which the 
snake grows after seeing 
something, making It easier to 
predict whether it's safe to eat 
something in your particular tight 
corner, but the * values could be 
anything up to 9, so making it 
almost impossible to predict if you 
can get out of the situation by 
eating it. The object of the game is 
to score as high as possible. In 
theory, the highest possible score 
is 1050, but | have yet to get near 
this - you'll find out why as you 
play the game. 


WINDOW #0,512,256,0,0 : PAPER #0,1 : INK #0,6 
: arrows$ = CHR$(188) &CHR$(189) &CHR$(190) &CHR$(191) 


150 CLS #0 : CSIZE #0,2,1 : AT #0,2,7 : PAPER #0,6 : INK #0,1 


160 PRINT#O,' "SNAKE" by Dilwyn Jones ' : 


170 AT #0,5,7 : PRINT #0,'Enter skill level 1-20! 
180 AT #0,7,7 : INPUT #0,'(1=difficult, 20=easy) » ';skill 


190 CSIZE #0,2,0: 
200 AT #0,0,0: 


PAPER #0,0 : 


IF skill « 1 THEN STOP 
CLS #0,3 : PAPER #0,1 : CLS #0,2 


210 FOR a = 0 TO 24 : board$(a) = FILL$(' ',42) 


220 FOR a = 1 TO skill 
230 REPeat loop 


240 x = RND(O TO 41) : y = RND(1 TO 24) 
250 IF board$(y,x+1) = ' ' THEN 

260 board$(y,x+1) = CHR$(48+RND(1 TO 9)) 
270 AT #0,y,x : PAPER #0,0 : INK #0,RND(2 TO 7) 
280 IF RND(1 TO 10) « 10 THEN 

290 PRINT #0,board$(y,x+1) ; 

300 ELSE 

310 PRINT #0,'*'; 

320 END IF 

330 PAPER #0,1 : EXIT Loop 

340 END IF 


350 END REPeat loop 
360 END FOR a 


370 REMark set snake start position 


380 REPeat loop 
390 sx = RND(5 TO 36) 


410 END REPeat loop 
420 length = 1: 


sx$ = CHR$(sx) 


: sy = RND(5 TO 19) 
400 IF board$(sy,sx+1) = ' ' THEN board$(sy,sx+1) = '0! 


: sy$ = CHR$(sy) 


430 dir% = RND(1 TO 4) : REMark «> v 


440 INK #0,7 : 


6 


AT #0,sy,sx : 


PRINT #0,arrows$(dir%) 


PAPER #0,1 : INK #0,6 


When the program starts, it asks 
for the skill level. Enter a number 
from 1 to 20.1 is very, very difficult, 
20 is easy. Try 10 to start with, and 
proceed from there. At the end of 
each game you can Set a new skill 
level to suit yourself. If you find the 
Skill level too slow, press any key 
to make the snake move at top 
speed (e.g. to get from one side of 
the screen to another more 
quickly). 

The snake is controlled with the 
cursor arrow keys. The snake's 
head is shown by an arrow, 
pointing in the direction in which 
the snake moves. To quit from the 
program, press ESC (or enter a 
skill value of 0). To pause the 
game at any point (eg. to answer 
the phone or wipe the sweat off 
your forehead) just press SPACE, 
and any key to restart. CTRL F5 
will achieve the same thing on a 
QL. 


: EXIT loop 
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1050 
1060 
1070 


grow = 0 : REMark counts down for growth of snake 
AT #0,0,0 : PAPER #0,0 : INK #0,7 : PRINT#O,'SNAKE by Dilwyn Jones'; 
AT #0,0,28 : PRINT #0,'SCORE:';length; : PAPER #0,1 
REPeat game 

key = CODE( INKEY$(skil1+1)) 

INK #0,6 : AT #0,sy,sx : PRINT #0, '0O'; 

old_sx = sx : old_sy = sy 

SELect ON key 

=27 : EXIT program : REMark ESC 


=32 : PAUSE : REMark Freeze, press any key to continue 
=192 : dir® =1 : REMark left 
=200 : dir% = 2 : REMark right 
=208 : dir% = 3 : REMark up 
=216 : dir% = 4 : REMark down 
END SELect 
sx = sx - (dir% = 1) + (dir% = 2) 


aon 


hod 
» 
er 


y = sy - (dir% = 3) + (dir% 
F sx « 0 OR sx > 41 OR sy « 1 OR sy >» 24 THEN 
INK #0,7 : AT #0,3,0 : CLS #0,3 
PRINT #0,'Off-screen!'; : EXIT game 
END IF 
IF board$(sy,sx+1) = 'O' THEN 
AT #0,3,0 : CLS #0,3 : INK #0,7 
PRINT #0,'Crashed into yourself!'; : EXIT game 
END IF 
IF board$(sy,sx+1) >» 'O' AND board$(sy,sx+1) <= '9' THEN 
REMark increment growth counter 
BEEP 1000, 5*(CODE(board$(sy,sx+1))-48) 
grow = grow + (CODE(board$(sy,sx+1))-48) 
REPeat Loop 
x = RND(O TO 41) : y = RND(1 TO 24) 
IF board$(y,x+1) = ' ' THEN 
board$(y,x+1) = CHR$(48+RND(1 TO 9)) 
INK #0,RND(2 TO 7) : AT #0,y,x : PAPER #0,0 
IF RND(1 TO 10) « 10 THEN 
PRINT #0, board$(y,x+1); 
ELSE 
PRINT #0, '*'; 
END IF 
PAPER #0,1 : EXIT loop 
END IF 
END REPeat loop 
END IF 
REMark new head for snake 
INK #0,7 : AT #0,sy,sx : PRINT #0, arrows$(dir?%) 
board$(sy,sx+1) = '0O! 
sx$ = sx$&CHR$(sx) : sy$ = sy$&CHR$(sy) 
REMark sort out the tail 
IF grow = 0 THEN 
REMark move tail 
AT #0,CODE(sy$),CODE(sx$) : PRINT #0,' '; 
board$(CODE(sy$) ,CODE(sx$)+1) = ' ! 
sx$ = sx$(2 TO LEN(sx$)) : sy$ = sy$(2 TO LEN(sy$)) 
ELSE 
grow = grow - 1 
length = length + 1: AT #0,0,34 : INK #0,7 : PAPER #0,0 
PRINT #0,length; : PAPER #0,1 
END IF 
END REPeat game 
BEEP 19000,0,100,120,1 : INK #0,7 
PRINT #0,' Another game Y/N?'; 
REPeat loop : INPUT #0,k$ : IF k$ == 'y' OR k$ == 'n' : EXIT loop 
IF k$ == 'n' THEN EXIT program 


s 
I 


1080 END REPeat program 

1090 AT #0,10,16 : CSIZE #0,2,1 : CLS #0,3 : PRINT #0,'GAME OVER.' 
1100 CSIZE #0,2,0 : PAUSE 100 : REMark viewing pause before job ends 
1110 STOP 
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Harddisks - Part 2 


Mark Knight 


The second part explains in detail how to handle subdirectories 
on your harddisk, how to deal with problems related to subdirec- 
tories and old QL programs which can't handle them. 


5. Using subdirecto- 
ries from SuperBASIC 
and SBASIC 


Unless you are familiar with sub- 
directory handling this section is 
best followed by having a blank 
floppy disk handy, and sitting with 
your QL ready to accept typed 
commands. It is also helpful to 
keep to hand a disk with some 
Quill documents on it (Text87 or 
Perfection documents will do just 
as well if that is what you use 
most). The examples given will all 
make more sense if you try them 
out and look at the effects on the 
screen and disk. 

There are a number of new 
SuperBASIC commands in the 
Gold Card and Super Gold Card 
ROMs and also in Toolkit Il which 
are designed to help you use 
subdirectories from the command 
line or in your programs. The Tool 
kit ll routines that allowed selec- 
tive wildcard directories now also 
work properly with modern QL 
subdirectories. Under SMSQ_ and 
SMSQ/E SBASIC has all these 
commands built in. 

The first command is obviously 
the one used in the example 
above, the MAKE_DIR command. 
This allows us to make a sub- 
directory on a specified device or 
on the default data device; the 
default devices may need explain- 
ing. Enter the following into your 
QL from the BASIC command line: 
els 
dlist 

and look at the result. You 
should see a list of QL devices, 
commonly it looks like this: 
FLP1_ 

FLP1_ 
SER 


.though your BOOT program 
may have changed it. So what is 
it? It's the list of defaults that Tool- 
kit ll adds to the system to save a 
little typing when loading or exa- 
mining files. The first is the DATA 
device, which is where DIR, WDIR, 
WSTAT and VIEW will look for files 
if you don't specify a device. So 
enter: 
dir 

on its own: you will get a 
directory of flpl. unless the data 
default has been changed. If you 
type: 
view flp2_boot 

.you would get a look at the 
boot file on the disk in flp2_ if 
there is one, if not an error Ente- 
ring: 
view boot 

Instead will give you a look at 
the BOOT program on flpl_ be- 
cause that is the data default. 
DATA_USE is the command to 
change this default, so: 
data_use flp2_ 

Will change it to flp2_. which 
often makes more sense. After 
entering the DATA_USE flp2_ com- 
mand above (try it} you will find 
that DLIST now gives: 
flp2_ 

FLPi_ 
SER 

The second item on the list is 
the PROGRAM DEVICE: this is 
used for the LOAD, LRUN, MERGE, 
EXEC and EXEC_W commands 
and others used for starting QL 
programs in SuperBASIC/SBASIC 
or machine code programs started 
with EXEC or EX etc. So if DLIST 
gives the above list, typing: 
load flp2_boot 

will work as normal, while: 
load boot 

_Will load the BOOT file from 


flpi_ as it is the current program 
device, similarly: 
exec devman_exe 

.would start a program called 
DevMan_EXE from flpi_ if it is sui 
table for the EXEC command. The 
default devices save typing and 
allow users to specify where they 
want data and programs to be 
kept. Since some modern QL pro- 
grams use these defaults they can 
be a good way to decide where 
such programs look for files. 

The final item listed by DLIST is 
the DESTINATION DEVICE, which 
is where the SPL and SPLF com- 
mands in Toolkit tl send files to be 
PRINTed and also where WCOPY 
will send files if it can. This item 
may be set either by the SPL_USE 
command or the DEST_USE com- 
mand depending upon what you 
are likely to use it for DEST_USE 
and SPL_USE work slightly diffe- 
rently even though they set the 
same default, so be careful. 

DEST_USE assumes you wish 
to use the destination device with 
WCOPY or COPY and so requires 
a directory device like a hard disk, 
floppy disk or even an old 
fashioned microdrive. If the name 
you specify does not end in the 
underscore character — then 
DEST_USE will add one, so: 
DEST_USE flp2_ 

Ol: 

DEST_USE flp2 

.Would both set the destination 
device to flp2. because without 
the underscore it would not be a 
full directory device name. If the 
data device is flpl. and the 
destination device is flp2_ then 
WCOPY on its own will copy files 
from flpi_ to flp2_ without further 
ado. 

SPL_USE is for use with the old 
Tookit ! background spooling 
commands and assumes nothing 
about the device you specify. SPL 
and SPLF are both commands to 
send a file, without header to the 
destination device while the QL 
does other things. So if you have 
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printed a Quill document (part one 
of your great novel, say) to a file 
called “flpi_Partt_LlIS’, setting the 
destination device to serl would 
be done by: 

SPL_USE seri 

then the command: 
spl flpi_parti_lis 

Will send the file to seri in the 
background. While the file is print- 
ing you may EXEC_W Quill again 
and work on part two without 
interrupting the printer By now 
hopefully you understand the de- 
fault devices, so put a spare blank 
disk in flpt_ and enter the follow- 
ing list of commands: 
prog_use flpi_ 
data_use flp1_ 
dest_use rami_ 
make_dir TEST 
make_dir TEST_DOCS 
make_dir BAK 
make_dir BAK_DOCS 
els 
dir 

You should get a directory of the 
disk something like this (assuming 
an HD disk, with DD or ED the 
sector counts will be different): 
SPARE 2859/2880 sectors 
TEST => 
BAK -> 

now enter: 
els 
dlist 

and you should see: 
flpi_ 
flpl_ 
ram1_ 

Now type the next command, 
the DDOWN command. Try: 
ddown test 
dlist 

.. and you get: 
flipt_test_ 
flp1_test_ 
rami_test_ 

DDOWN is a command to move 
“into” or down the directory tree, 
that is to change the defaults to 
look into a directory, so: 
dir 

NOW gives: 
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BLANK 2859/2880 sectors 
TEST. DOCS -> 

.this indicated that there is a 
further subdirectory called DOCS 
in the test directory and: 
dup 
dir 

QiVes: 
BLANK 2859/2880 sectors 
TEST => 
BAK => 

The DUP command is to move 
up (or out of) the directory tree. 
Note that directory trees are up- 
side down, that Is up moves to- 
wards the root and down moves 
away from the root. The root in 
this case Is flpl. because we 
can't back out of the tree any 
further than that. As well as 
DDOWN and DUP there is DNEXT, 
which in theory is to move to ano- 
ther directory at the same level, 
though it works a little oddly at 
times. To go into the TEST direc- 
tory again type: 
ddown test 
dir 

and check the screen, then 
type: 
dnext bak 
dir 

and you will see we have 
moved from TEST to the next 
directory, BAK, and 
now: 
dup 
dir 

shows us we are 
back at the root. lf we 
type the 
EXACTLY as shown: 


100 rem 
110 rem 
120 rem 
dup 
dup 
ddown test 
save Test_BAS 
dir 

.we should see: 
BLANK 2856/2880 sectors 
TEST_DOCS -> 
test_Test_BAS 


this indicates that DOCS is a 
further subdirectory in the TEST 
directory and we now have a file 
called Test_BAS. also in the TEST 
directory. Now enter the following, 
once again exactly as shown: 
dest_use flp1_BAK_ 
weopy 

and when the "Y/N/A/Q" ap- 
pears, press "Y”. Now type: 
dir 
dnext bak 
dir 

and you will see where the 
WCOPY command has copied the 
file but this time with the first part 
of the name in upper case be- 
cause that is how the default was 
specified. Most users stick to 
lower case all the time for directo- 
ries for ease of typing but | like to 
stick to upper case to separate 
files from directories. 

In case you forget the order of 
devices given by DLIST there are 
three functions you may use to 
obtain the devices separately, 
these are DATAD$, PROGD$ and 
DESTD$. To use them, type com- 
mands like the following: 
print datad$ 

Of put some code in your pro- 
grams resembling this fragment: 


13750 PRINT "Programs on ";PROGD$ 
13760 PRINT "Data on ";DATAD$ 
13770 Destination$=DESTD$ 

13780 IF Destination$ 
(LEN(Destination$) )="_"" THEN 


following, [13790 PRINT "Destination default is | 
";Destination$ 

new 13800 ELSE 

13810 PRINT "Spooler device is 
";Destination$ 

13820 END IF 


6. Using subdirecto- 
ries with modern QL 


programs 

To save a file into a subdirectory 
call ‘DOCS’ on flpt_ all we need to 
do when saving the file is to start 
the filename with ‘DOCS’, so if 
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the program prompts us for a 
filename we may type "DOCS_Go- 
Away.DOC" or whatever Some 
programs allow you to configure a 
device and directory name into 
them and will look in the specified 
directory for startup or datafiles. 
Read the instructions carefully and 
experiment with a floppy disk or 
two, creating subdirectories from 
within the program if it allows and 
from SuperBASIC or SBASIC as 
well. 

One of the things that is some- 
times forgotten is that on the QL 
the directory name ts part of the 
filename. In QDOS and SMSQ and 
SMSQ/E the filename is limited to 
36 characters in length which 
means that the directory name 
and filename together must not 
exceed this length. Remember 
also if you have a directory name 
that is ten characters long this 
shortens the length of filename 
you may use in that directory by 
eleven characters because of the 
need for the underscore as a 
separator. 

In spite of the above always try 
to choose names for subdirecto- 
ries that make it easy to remem- 
ber what the contents are. There 
is a lot of frustration in knowing a 
file is on your hard disk but not 
being able to find it, There are 
search aids available but it is obvi- 
ously quicker not to lose track of 
them in the first place and choos- 
ing directory and filenames in a 
systematic manner helps a lot. You 
need not adopt any system sug- 
gested by others if you don't want 
to but make sure you have a sys- 
tem of some sort. 


7. Using subdirecto- 
ries with QUILL 


This section is a “hands on‘ sec- 
tion and contains listings and in- 
structions that should be typed 
into a QL to install Quill on your 
hard disk. | have no use for Quill 
since | obtained DP’s Editor and 
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later Perfection, but | understand 
many still use the Psion programs. 
Start by making a subdirectory to 
keep the program files, help files 
and Printer_DAT file in. say with: 
make_dir wini_QUILL_ 

So far things are simple but to 
access files in our new QUILL sub- 
directory we must prefix them with 
"QUILL, so a document with the 
filename “BadDebti_DOC’ must be 
loaded by typing 
*‘winl_QUILL_BadDebti_DOC’ or 
“QUILL_BadDebti_DOC’ if Quill is 
already using wint_ for files. The 
trouble is Quill only allows one 
underscore (_’) character per 
filename and another to separate 
the device name. 

There are ways to fool Quill into 
using the facilities however using 
new device drivers which pretend 
to be old fashioned QL devices 
but actually just ‘point’ themselves 
at subdirectories on modern devi- 
ces. This allows Quill to see a new 
device, called sub2_ for example, 
so "sub2_BadDebtl.DOC’ really 
means *wint_QUILL_BANK_ 
BadDebtl_DOC’. 

Most advice on this subject will 
recommend the use of the DEV 
device driver in the Gold Card and 
Super Gold Card ROMs, but | 
would actually recommend some- 
thing else: Use Phil Borman's SUB 
device. This is much better at pre- 
senting directory listings than the 
DEV device and doesn't mess up 
the Quill files display as DEV will if 
the path is fairly long. Look on the 
disk that came with QUBIDE for 
the text file called SUB_TXT and 
the SUB_BIN file. 

SUB_BIN is intended to be loa- 
ded on your QL using LRESPR or 
the usual RESPR, LBYTES, CALL 
sequence. As an example | will run 
through an installation of Quill on a 
hard disk, providng a BOOT 
program as well. If you follow the 
explanation you should be able to 
substitute Abacus, Archive or 
Easel at will and decide on the 
subdirectory names yourself. First, 


make subdirectories: here we will 
make four but you should see 
how to expand this. Remember 
the limit is eight as QL devices 
cannot have numbers higher than 
that, so subl_ to sub8_ is OK but 
don't try to create a sub9_. you will 
be wasting your time. From the 
command line type: 
make_dir wini_QUILL_ 
make_dir wini_QUILL_DOCS_ 
make_dir wini QUILL_BANK_ 
make_dir wini_QUILL_PERSONAL_ 
OK so we've made a subdirec- 
tory called QUILL and inside it 
there are three more, one for 
general documents, one for letters 
to the bank and another for per- 
sonal letters: what now? Assum- 
ing you already have Quill working 
ona floppy disk MAKE A COPY of 
the disk, put THE COPY in flpt_ 
then type: 
lrun flpiconfig_bas 
then configure the quill devi 
ces: make the device for the 
Printer_DAT and help files subt_, 
the help device the same and the 
device for document files sub2_. 
Once this is done for the copy of 
Quil on your floppy — exit 
Config_BAS and type: 
weopy flpi_ to winiQUILL. 
think about which files you 
want, Quill itself being obvious but 
Printer_.DAT and the help file 
(Qui_HOB} being among the 
others. For each file you want type 
"Y" or press ‘A’ if you want them 
all moved to the hard disk - don't 
do this if there are tons of docu 
ment files on your Quill disk, put 
them in the subdirectory files later 
Once this ts done type in the 
program listing 1 and when you 
have finished save it as 
‘winl_QUILL_BOOT’. 


Once you have done this all you 
have to do to use QUILL from your 
hard disk is enter: 
lrun wini_quill boot 

While Quill is in use simply save 
to sub2_ or sub3_ or any other 
devices you have set up. To back 
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Listing 1: 


100 TK2_EXT : REMark Make sure Toolkit II is ready for use. 
; 110 WIV 4 : REMark Select TV window arrangement but in mode 4. 


120 DATALUSE "" ; 
130 PROG_USE "" 
140 : 


REMark Cancel Toolkit II defaults, Quill can be confused. 


150 REMark Next few lines loads SUB_BIN unless it is already loaded. 


160 REMark FOP_OVER is a Toolkit II function (Function OPen for OVERwrite) 


| 170 : 


| 180 Testing=FOP_OVER(#3, "subi_Test") 


190 IF Testing<0 THEN 


200 REMark if using HOTKEY system next line should have REMark removed 


210 REMark HOT_STOP 
220 : 


REMark if using HOTKEY system next line should have REMark removed 


REMark HOT_GO 


CLOSE#3 
DELETE "subi_Test" 


330 SUB_DRV "wini" : REMark Select which drive you wish to use with SUB 
| 340 REMark Don't use "winl_", SUBLDRV needs devices without the underscore. 


350 : 


LRESPR “wind _QUILL_SUB_BIN" 


360 SUB_LUSE 1,"QUILL." : REMark Now subi_ = wini_QUILL_ 
370 SUB_USE 2,"QUILL_DOCS_" : REMark Now sub2_ = wint QUILL_DOCS_ 
380 SUB_USE 3,"QUILL_BANK." : REMark Now sub3_ = wini_QUILL_BANK_ 


390 SUBLUSE 4,"QUILLPERSONAL_" : REMark Now sub4_ = wind _QUILL_PERSONAL_ 


1400 : 


| 410 REMark add/use your own subdirectories up to sub8_ if you wish. 
420 FORMAT "rami" : REMark Clear a ramdisk 


430 FORMAT "rami_200" : REMark Now reformat to a fixed size of 200 sectors 


440 : 


450 AT 2,28:PRINT "LOADING QL QUILL" 


460 AT 4,30:PRINT "Version 2.3" 
470 AT 6,23:PRINT "Copyright 


490 BAUD 9600 
500 EXEC_W "subi1_QUILL" 


510 REMark After Quill quits WCOPY documents on rami_ to wini_QUILL_DOCS_ 
520 WCOPY "rami__DOC" TO "sub2__DOC" 


| 530 STOP 


up use your normal hard disk 
backup method or save files 
twice, once to a SUB device and 
once to flpt_ as well. Using the 
above example most people 
should be able to write suitable 
BOOT programs for Abacus, Ar- 
chive or Easel if they want. A sig- 
nificant advantage is that each of 
the Psion suite can have a sepa- 
rate Printer_DAT file in their own 
subdirectory, so switching from 
one to the other is not such a 
hassle if you want Quill to use 10 
or 12 characters per inch and 
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1984 PSION LTD" 
480 AT 8,29:PRINT "Word Processor" 


Abacus to use 20 characters per 
inch to fit bigger spreadsheets in. 
These methods can also be 
adapted for any program which 
refuses to recognise subdirecto- 
ries because it is old software or 
badly written. Modern QL pro- 
grams use subdirectories and you 
Should really learn to use these 
facilities properly rather than adop- 
ting the above methods when 
they are not needed. It may take 
time and effort - | know some 
people aren't keen on effort (most 
people perhaps) but it is worth it. 


8. A nifty trick with 
a hard disk drive 


One of the troubles that 
might come with having a 
hard disk drive is remembe- 
ring where everything Js, 
especially if you have do- 
zens or hundreds of EXE- 
Cutable files. It may surprise 
you to know that in order to 
EXEC a file on a hard disk 
you dont need to know 
where it is. As long as you 
keep the program files in a 
set of directories no longer 
than eight items long you 
can just EXEC them, for 
example to EXEC Perfec- 
tion and Editor SE you 
would just enter: 
exec perfection 
exec edt_bin 

even if Editor is in 
wini_EDT_ and Perfection 
is in wint.PERF. and you 
would not need to change 
the program default in bet- 
ween. As well as this you 
might know that you have 
my PopCalc calculator in 
EITHER winiUTILS_ OR 
wini_SYS_ and yet to exec 
that to multitask alongside 
Editor and Perfection you 
would simply type: 
exec popcalc 

How is this trick done? 
Using the DEV device men- 
tioned earlier; DEV is not 
the best way to work with Quill or 
the other members of the Psion 
suite but it is superb for use with 
EXECutable files. DEV and SUB 
are rather similar in what they aim 
to do, so | will revisit SUB to 
explain the differences. Assuming 
there are subdirectories on winl_ 
called EDT and DOCS if we type: 
sub_drv winl 
sub_use 1,_EDT_ 
sub_use 2,DOCS_ 

.then loading subl_ReadMe_ 
TXT will fetch wint_EDT_Read- 
Me_TXT and loading sub2_Read 


= 


Me.DOC with Quill will fetch 
wint_DOCS_ReadMe_DOC, fool 
ing Quill into loading the document 
without breaking its outdated rules 
about filenames. Similarly we can 
set up DEV to do the same using 
the DEV_USE command thus: 
dev_use 1,wini_EDT_ 
dev_use 2,wini_DOCS_ 

If we load dev2_ReadMe_DOC 
into =6- Quill” «SO swe so will_~— fetch 
wint.DOCS_ReadMe_TXT just as 
with sub2_ReadMe_DOC earlier. 
However if we type: 
dir sub2_ 
dir dev2_ 

the results are rather different. 
With sub2_ we might get some- 
thing like this: 

SAUSAGES 58052/83044 sectors 
ReadMe_DOC 

HardDsks_DOC 

Damage_DOC 

..but with DEV we will get the full 
filenames; e.g: 

SAUSAGES 58052/83044 sectors 
DOCS_ReadMe_DOC 
DOCS_HardDsks_DOC 
DOCS_Damage_DOC 

this makes DEV less suitable 
for use with the Quill directory 
listing as the names are some- 
times long enough to overlap 
names in the next column or wrap 
around onto the next line. With 
SUB this long filename problem 
does not occur but DEV has a 
useful trick up its sleeve that SUB 
can't match. DEV will chain, that is 
it will store a search path for a file 
as opposed to just one directory. 
For example if we type: 
dev_use 1,EDT_,2 
dev_use 2,D0CS_,3 
dev_use 3,TXT_,4 
dev_use 4,LETTERS_,5 
dev_use 5,LETTERS_WORK_,6 
dev_use 6, LETTERS_STUDY_,7 
dev_use 7, LETTERS_FAMLY_,8 
dev_use 8,INFO_,1 

we set up DEV so that it will 
search all the listed directories in 
the given order If we ask for 
devi_ReadMe_DOC using Quill 


12 


then dev will first try wint_EDT_ 
ReadMe_TXT and then wint_ 
DOCS_ReadMe_DOC and so on 
down the chain. Note that this 
chain wraps around, so starting 
with dev8_ReadMe_DOC will try 
wint_INFO_ReadMe_DOC _ then 
winlt_EDT_ReadMe_DOC and 
then wini.DOCS_ReadMe_DOC 
as before. When DEV has tried all 
the devices from devi_ to dev8_ 
it will give up, even if the chain 
wraps around like this one. 

Assuming we have the direc- 
fories present on a hard disk the 
following program will set up the 
system so that EXEC will search all 
those in the listing. It is only neces- 
sary to keep all our program files 
in one of the eight listed directo- 
ries to alow us to EXEC them 
even il we have forgotten which 
directory they are in. As BAS- Is 
on the list, presumably where 
SuperBASIC/SBASIC listings are 
kept, you can also LOAD a pro- 
gram just by typing the filename, 
e.g: 
load FileMan_BAS 

would load winl_BAS_ 
FileMan_BAS. You should naturally 
substitute your own directories for 
those in the listing. 

100 TK2_EXT 

110 DEV_USE "hdk" 

120 DEV_USE 1,"wini_UTIILS_", 
130 DEV_USE 2,"winl_SYS_",3 
140 DEV_USE 3,"wind_PERF_",4 
150 DEV_USE 4,"wind_EDT_",5 
160 DEV_USE 5, "wind _QPAGE_",6 
170 DEV_USE 6,"winl_IDE_",7 
180 DEV_USE 7,"wini PSION_",8 
190 DEV_USE 8,"wini BAS_",1 
200 : 

210 DATALUSE "wini" 

220 PROG_USE "hdki_" 

Note that you don't have to 
keep a program and its data in the 
same place, for example Quill 
Archive and Abacus could all be in 
the PSION subdirectory while 
there is a directory called QUILL 
for the Quill Printer_.DAT and 
Quil_HOB files, another called 


SPREADS for the Abacus files etc. 
You can configure Quill to use 
sub2_ which is really wint QUILL. 
DOCS. or whatever while Quill 
itself is in the file wint-PSION_ 
QUILL so the DEV search will find 
it. | use a version of this listing to 
set up Turbo so all | have to do is 
type LOAD FileName_BAS then 
use the CHARGE command and 
Turbo loads winl_TURBO_Parser_ 
TASK and winl.TURBO_Code 
gen_TASK. QLiberator and Super- 
charge can be persuaded to do 
similar tricks using DEV. 

If you decide to buy QUBIDE (or 
one of the other QL compatible 
systems that can use a hard disk 
like a QXL, QPC or an Atari QL 
emulator) | would suggest you 
don’t load much software onto the 
hard disk right away. Instead spend 
some time experimenting with 
DEV, SUB and the various ways of 
setting up subdirectories before 
you design a system for using 
your hard drive that will suit you. 
As soon as you start keeping real 
work on your hard drive buy a 
backup program and use it. 
fa 
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The Leap Back 


Adrian Ives 


Come back from PC to QL? Some people did it recently, and 
Adrian writes his experiences down for you - more reasons to 


stay with the QL. 


Until some time around October 
last year | hadn't touched a QL in 
almost five years. My job had 
made it impractical to continue 
using the QL as more than just a 
curiosity, and so my ‘kludged’ QL 
+ Trump Card + Miracle Hard Disk 
was consigned to the spare room. 

With a change of job into project 
management, | had less need to 
maintain an in-depth knowledge of 
the PC and its development tools, 
and, frankly, | was getting very 
bored with WinSLOTH 95 and the 
"MicroHard’ range of disk-gobbling 
behemoths. 

When | was allocated a rather 
nice Pentium Lap Top, which came 
as part of the job, | no longer felt 
the need to keep my ‘own’ PC at 
home. So, off it went - obsolete, 
anyway, just five months after | 
had built it from ‘state of the art’ 
components! 

When | look at the PC today, | 
wonder where it will all end. The 
entry-level machine now is a Pentr- 
um 166 (Sorry, just heard, make 
that a 266 so that you can run 
NotePad) with 64MB RAM and 
2GB of Hard Disk! And don't forget 
the mandatory Hextuple speed 
CD-ROM | mean .. give me 
strength! 

And just look at some of that 
software - sure, it looks nice; it 
comes in a nice box on i5 CD- 
ROMs; plays music; warps the 
fabric of sub-space; displays dia- 
log boxes in three dimensions .. 
and locks up more times in 30 
minutes than my QL has done ina 
lifetime! 

Anyway, enough of irrelevan- 
cies. | had been thinking about a 
short article for QL Today for a 
couple of months now, so | 
thought it was about time to load 
Text87 Plus4 (in just 1.9 seconds 
from my QUBIDE Hard Disk - Word 
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95 takes a staggering ten times 
as long on a machine several or- 
ders of magnitude more ‘capable’). 

The question is: What should | 
write about? And who would be 
interested anyway? | suppose a 
good starting point is probably to 
describe what hardware | run - 
there seems to be an immense 
variety across the QL community ... 

| run Aurora, Super Gold Card, 
superHermes, and QUBIDE driving 
a Western Digital 1.2GB Hard Disk. 
All of tt is packaged in a PC mini 
tower case, wifn an IBM 15x 
SVGA monitor Canon BJC250 
printer CisCom 33600 Voice/Data 
FAX Modem, and PC keyboard 
and mouse. Yep, it looks just like a 
PC - except that it boots up in 
about one thirtieth of the time! | do 
like seeing the look of surprise on 
people's faces when they DON'T 
see an improperly rendered bit- 
map of a cloudscape appearing 
two minutes after switching the 
machine on. 

In the Spare room is my original 
QL (what I call the "QL Classic’). In 
fact, The Classic is barely recog- 
nisable as a QL. A long time ago, 
the black plastic *2001 Monolith’ 
housing was stripped off, and the 
main board mounted in a heavy 
duty steel case that formerly 
housed a very old CP/M micro- 
computer. 

The multirai power unit in this 
case was ideal for driving the QL, 
and banished forever the infamous 
power glitch problems of yester- 
year. The Trump Card was a pro- 
blem, though, extending about 
four centimetres out of the end of 
the case - so | had to construct a 
housing out of a Maplin project 
box to protect it. Like | say, a 
strange looking beast indeed. But 
it worked, and it was (is} very 
robust and reliable. 


In fact, it’s from the QL Classic 
that my current system was in- 
spired. After five years of neglect, 
the Miracle Hard Disk had stopped 
performing miracles, and was 
siezed solid. | could not find an XT- 
style Hard Disk for love nor money. 
Was the Quantum Leap doomed 
to end its days gathering dust in a 
corner? 

Well, almost. Jochen Merz, for 
some strange reason, had contr 
nued to send me his catalogues - 
even though | hadn't placed an 
order with him for a very long 
time. | noticed the QUBIDE inter- 
face, did a quick conversion of 
Sterling to DM and thought ‘why 
not?’, 

| was very pleased to find that 
the QUBIDE worked first time. 
While | was at it, ! decided to give 
QL Today a try and ordered a 
year’s subscription. Without bor- 
ing you, this was the start of some 
frantic spending (Jochen, Roy 
Wood et al - | think you're all a bit 
better off as a result!) that resulted 
in my current system. 

| had set out just wanting to get 
the old QL up and running as a 
hobby, but | was amazed by the 
number of loyal QLers. still out 
there, and by the hardware and 
software, much of it of a very high 
quality, that was still under deve- 
lopment. Once | started fiddling 
around with S*BASIC extensions 
and completing some half-finished 
utilities written in QLiberator, it all 
came flooding back. 

| can say, without a doubt, that 
the QL is by far the easiest ma- 
chine { have ever developed soft- 
ware on. It is clean and elegant, 
and avoids the ‘BloatSoft' ap- 
proach that dogs the poor PC. 
Long may it continue. 

Its good to be back. For my 
money, the move from the PC to 
the QL really is a “Quantum Leap’. 

ps: If anyone wants my old 
Miracle Hard Disk interface card 
(no case and no guarantees) send 
me an E-Mail: ADlves @aolcom 
| 
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MTOOLS - A Review 


Timothy Swenson 


Jonathan Hudson has ported the Unix utility, Mtools, 
to QDOS. In the Unix world, Mtools is a set of utilities 
that read, write, and navigate MS-DOS disks. With 
Unix, a single program can be called by different 
names and have different behavior. In QDOS this is not 
possible, so the full set of these utilities is the program 
*mtools”. 

Mtools is essentually an implementation of a number 
of MS-DOS commands, such as COPY DIR, DEL, 
TYPE. CD, MD, RD, DELTREE, ATTRIB, etc. Mtools can 
handle both DD and HD 3.5" disks. | have not tested it, 
but it should handle 5.25° disks also. 

The mtools_zip file contains the Mtools executable, 
the Mtools manual, a Q(DOS README file, and a num- 
ber of Unix man (manual) pages for each of the com- 
mands. The manual covers all of the commands. The 
man pages are added only for completedness. 

Besides the Mtools executable, a configuration file 
and environment variable are neeed. This means that 
you must have environment variables (ENV_BIN) sup- 
port loaded. 

The Mtools configuration (mtools_conf) defines how 
your disk drives are setup and how you want to use 
Mtools. The configuration file is a text file and can be 
created with any text editor The main thing that is 
needed in the configuration file is the definition of your 
disk drives. You must define what drives you have, 
what format they are, and what they are called in 
MS-DOS terms. In my case | have a single HD disk 
drive, so use the following configuration entries: 
drive a: file="flp1_*d2h" 1.44m 
drive a: file="flpi1_*d2d" 720k 

The first line tells mtools that | am using FLP1_ as 
the MS-DOS drive A: and that it is an HD (1.44 MB) 
drive. The second line says that the same drive can 
also be a DD (720k) drive. The items ‘flpi_*d2h" and 
“flpi.*d2d" come directly from the ToolKit ll manual 
and are the direct sector reading devices. This is how 
Mtools knows how to read the disk drive. If you only 
have 1 DD drive, then you would use only the second 
line. If you have a second disk drive then you would 
just add lines with “drive b:. For ED disks, | believe the 
device needed Is ‘flpi_*d2e" and it is only 2.88 Meg. 
MS-DOS did not support the ED drives at 3.2 Meg. 

Once | had a configuration file created, | needed to 
tell Mtools where to find it. | used the SETENV 
command like this: 

SETENV "MTOOLS_RC=ram1_mtools_conf" 

Since | only have one disk drive, | have to keep all 
my QDOS files on RAMi_, FLPi_ is used as the 
MS-DOS disk. You would use whatever device you are 
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using for your QDOS files (FLP2_, WINL_. etc). 

The next thing | needed to do is to set the 
DATA_USE and PROG_USE devices to the device | 
am using for QDOS files (RAM1_). Mtools has a pro- 
blem using QDOS device names, so it is better not to 
use them and let DATA_USE/PROG_USE handle them. 


Now | put an MS-DOS disk in the drive and execute 
Mtools: 
exec mtools;"-c mdir a:" 

Because of how Mtools was written and how 
QDOS is, Mtools must be given a *-c’ argument and 
then the command to run. Mtools also puts a 'm’ 
before each standard MS-DOS command name. What 
| am doing is ‘DIR A: in MS-DOS terms. Once Mtools 
executes, a window pops up and after a bit of reading 
the disk, a MS-DOS-looking directory of the disk 
appears, including any directories on the disk. 

To copy a file from MS-DOS to QDOS Mtools is 
executed like this: 
exec mtools;"~c mcopy a:file.ext file_ext" 

| am telling Mtools to copy the file ‘a-ileext’ to my 
QDOS device (set by DATA_USE) as the name 
file.ext. Mtools recognizes the ‘a: as an MS-DOS 
device and knows where to get the file. 

Copying a file from QDOS to MS-DOS would go 
something like this: 
exec mtools;"-c meopy file_ext a:" 

Mtools knows to convert the — in file_ext to a 
standard MS-DOS period. Now if | had run Mtools like 
this: 
exec mtools;"-c meopy rami_file_ext a:" 

then a file called ‘ramt_file.ext’ would have been 
copied to the MS-DOS disk. Remember, Mtools does 
not know how to handle QDOS device names. This is 
why | set DATA_USE to RAML_. 

Mtools supports the newer MS-DOS file systems 
that allow lower case and longer file names, now used 
by Win95 and NT Any files copied to MS-DOS in all 
caps will remain in all caps. 

Because of a problem with C68, Mtools has a 
problem handling the MS-DOS device/file separator 
back slash (\). In my testing | tried to create a 
directory TEST | used the Mtools commana: 
exec mtools;"-c mmd a:\test" 

Mtools seemed to translate the \t into the Tab 
character and wanted to create a subdirectory ’a: est’. 
To get around this problem you have to use two back 
slashes (\). So this command would work: 
exec mtools;"-c mmd a:\\test" 

Mtools also supports the standard Unix seperator 
slash (/). So this will also work: 
exec mtools;"-c mmd a:/test" 

Mtools supports the following commands: 
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Mattrib - Used to change MS-DOS file attribute flags. 
Mbadblocks - Scan an MS-DOS floppy and mark 
unused bad blocks as bad. 

Mcd - Change directory. 

Mcopy - Copy a file. 

Mdel - Delete a file. 

Mdeltree - Delete a whole directory tree. 

Mdir - Directory of an MS-DOS disk. 

Mformat - Format an MS-DOS disk. 

Minfo - Print paramaters of MS-DOS file system. 
Mlabel - Label disk. 

Mmd - Create a subdirectory. 

Mmove - Move a file (Rename). 

Mrd - Deleie a directory. 

Mren - Delete a file. 

Mtype - Copy a file to the screen. 

Xcopy - Copy a directory tree to another. 


| did have one problem with Mtools that Jonathan 
and | have not sorted out. Mtools seemed to have 
problems formating MS-DOS DD disks on a HD drive. 
lt formatted the HD disks just fine. Since | only have 
the one disk drive, | can’t rule out my drive as being 
the problem. 

| have also noticed that NT seems to have a 
problem formatting 720K disks also. | formatted a 
720K disk on an NT machine at work, brought it home 
and tried to read it. Mtools failed to read it, anong with 
another MS-DOS disk reading utility [ve been using 
for years. | doubt an old MS-DOS 3.3 system would 
also be able to read the disk. 

Mtools Is a fairly powerful set of utilties. All of the 
commands and the configuration file have a lot more 
options that | have discussed. At first it may seem a 
bit overwhelming to have to many configuration 
options, but the simple configuration file like the one 
listed above should suit most uses. The manual is 
fairly thick but it is very thorough and between it and 
the QDOS README file, most of your question should 
be answered. | wrote this article in such a way that it 
can be used as a ‘quick start’ document and get you 
up and running. 

Mtools may not be for everyone and most who use 
it will only need to use just a few of the commands 
(DIR & COPY), but | am finding it very handy. Now that 
720K disks are going out of style, | needed a way to 
read HD disks on my QL. Mtools fills this need very 
well. 

Mtools can be found from most QL Freeware 
sources, includes QL BBS’s, and on Jonathan's Web 


page. 
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[Editor's note: Tims article did not make it into the 
previous issue and was waiting here for three 
months. As we all know, Jonathan is quite productive 
and therefore we asked him if he had any comments 
about improvements. Here is his reply: 

.. | think Tim’s article misses (or only covers very 
superficially) the two most important things about 
mtools. 

1. It supports VFAT (long file names in W95 and NT) 

2. It supports sub-directories on DOS media 


Tim and Adrian Ives were very helpful in debugging 
mtools; Adrian wrote to me: “One thing | will say: 
MTOOLS is an order of magnitude faster than the 
SMSQ copy routines. | do a hell of a lot of copies 
between PC and QL, and I have been using QPAC for 
this. Copying a 500K file off an MSDOS disk can 
sometimes take several minutes! MTOOLS does it in 
about ten seconds!” 


Adrian’s SHELL program supports aliases for the full 
mtools command set, so using that you can do 

mdir a: 

mcopy b: 

etc.’] 
= 


The Pandora Case 


review by John Peace 


About a year ago | decided to upgrade my QL. My 
equipment at the time was the usual black box with 
standard Hermes, Minerva, Super Gold Card and 
double ED Disc Drives. | was still using my old Phillips 
monochrome monitor and decided it was time to 
redesign my system completely. | opted for an Aurora 
board with a 16Gb hard disc and SMSQ/E plus 
whatever | could salvage from my existing set-up. | 
also bought a 15° SVGA monitor and Acer keyboard. 

John Southern’'s offer to build systems using the 
North Manchester Group's Pandora Box persuaded 
me to use this rather than a converted PC case. | 
have now been using my new system for about a 
year. 

The case itself is made from fairly heavy gauge 
steel sheet sprayed black inside and out. It is very 
robust and consequently a little on the heavy side. 
The case is 50 cms. (20 ins.) long and the ends are 
17cms. (seven inches square, ie. just wide enough to 
take 5.25° drives). A kind of bonnet, retained by six 
screws at the base, lifts off leaving the sides and most 
of the top open for access. 
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A recessed retractable handle ts fitted in the centre 
of the case top and although the Pandora I's rather 
heavy it is very well balanced and easy to carry. 

As supplied the unit has bays for three 3.5 inch and 
two 5.25 inch drives. There are holes to carry five 
9-pin and two 25-pin PC type connectors plus a 5-pin 
DIN socket for the keyboard. Although the the 
number of I/O leads fom QL peripheral boards can 
greatly exceed this, there should be enough sockets 
for most requirements. Certainly there are enough for 
mine. 

The Aurora board is fixed to the base with four 
bolts fitted with 0.5cm. spacers and has just enough 
clearance at ihe back of the case to allow a QPlane 
to be fitted. 

The Super Goldcard fits in upside down and the 
large heat sink prevents it from occupying the lower 
Slot of the QPlane, so the Qubide went there with the 
Goldcard immediately above. Since the Qbide is very 
Short it doesn't get in the way of the heat sink. 

The location of the various drives needs to be 
carefully worked out to avoid too much twisting of the 
connecting ribbon cables - there isn't a great deal of 
spare space and there are quite a lot of cables going 
back and forth. Ribbons going to sockets at the rear 
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of the Pandora will probably need to be routed 
underneath the Aurora. 

One of the main selling points of the Pandora is its 
portability. Over the past year | have taken the 
equipment to QL group meetings etc. and have found 
it very convenient to carry around, although | still 
seem to have as many loose bits as ever | suppose | 
am just aquiring more of them. 

The one serious problem is not directly connected 
to the Pandora but is caused (I think) by the large heat 
sink on the Goldcard. When carried in the car boot it 
bounces up and down and the bottom connector on 
the QPlane has become loose. A little judicious 
packing will hopefully have solved the problem and | 
am keeping my fingers crossed. | understand John 
Gilpin is already looking into the problem. 

Overall | am quite happy with the Pandora Box. The 
case will stand fairly rough handling without harm, it 
can be moved around with one hand and the top 
presents a flat surface for external peripherals etc. 
Three of the 9-pin sockets are on the front of the 
case where they can be used for the more frequently 
changed equipment and generally | find it more 
convenient than, say, a tower case. 

& 
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Assembly Language 
Programming - Part 1 


Norman Dunbar 

This series of articles is intended to let you in 
on the basic secrets of programming your QL in 
its own natural language - machine code or 
assembly language. It will not just be a 
summary of 68000 instructions, no, this series 
will teach you how to program your own 
machine code programs under QDOS. 


Assembly language is very, very simple. Not many 
people will agree at first, but if you think about it, it is. 
You have to tell the processor what you want it to do 
in very simple steps. In SuperBasic, you can multiply 
two numbers together easily - you can do it almost as 
easily in machine code too. 

This series of articles is intended to let you in on 
the basic secrets of programming your QL in its own 
natural language - machine code or assembly lan- 
guage. (Actually, machine code is what the QL talks, 
we use assembly language which is ‘English’ sound- 
ing ‘words’ that get converted to machine code by an 
assembler - | will tend to use the two terms as one) 

To talk directly to the QL, you must learn its lan- 
guage. This series should hopefully teach you how to 
do just that. | make no assumptions about how much 
or how little you may already know - | will start very 
simple and continue from there. Hopefully you will 
have an assembler, but if not, | will be presenting each 
program or code fragment - at least the ones that you 
can run - as both an assembly language listing and as 
a hex listing along with a small SuperBasic program to 
convert the hexadecimal numbers into a machine 
code file ready for use. 

| was going to base the series on George Gwilt’s 
GWASM assembler, which is free and can be distri- 
buted easily. Unfortunately, it won't run on anything 
less than a 68020 which is no good for those of us 
who are still running on an original QL - anyone out 
there got a free assembler for the masses? 

Most assembly language books tend to give litile 
example programs as they go along to try to show 
the bits of the instruction set that you have just 
learned about. | will attempt to do likewise, but in 
addition, we will develop a useful application as we go 
along as well - the project! 


The Project 
As we go along, we'll be developing a small but 
hopefully useful program, which may not have too 
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many bells and whistles, but should just work! 


Now that | have said that, | suppose | will have to put 
my machine code where my mouth is! 


The 6800x Processor 

The processor we are programming is one of Moto- 
rola’s 68000 series. Be it a 68008 or a 68060 (if you 
are lucky) all of them have the same basic instruction 
set, although some of the more powerful processors 
have additional instructions. Partly because we have 
to cater for those on an original QL but mostly 
because | don't have a clue about these additional 
instructions, we will be dealing with the basic instruc- 
tion set - there is enough there to keep us happy for 
a while. 

Inside the processor there are a few different parts, 
but we are only concerned with the registers - the 
rest just does the work and puts the results some- 
where, setting a few flags along the way. Talking of 
flags, we will also take a look at the status register - a 
very important part of programming. 


Registers 

Registers are where numbers get loaded into, mani 
pulated and written out from. Some instructions ope- 
rate directly on memory locations, but to all intents 
and purposes, memory is just another register but 
outside of the processor and a lot slower. 

The 68000 - which is the term | shall use from now 
on to describe the entire family of processors - has 
different types of registers - data, address, status and 
program counter. 

Data held in registers and in memory is held in High 
Order format. This simply means that the numbers are 
Stored in a similar manner to the way in which we 
would expect them to be - the ‘rightmost’ end holds 
the most significant bit and the ‘leftmost’ the lowest - 
just the way we write numbers down. 


Data Registers 

There are 8 data registers named DO to D7 and 
these can be used to perform manipulations on the 
numbers that are held in them. Each register can hold 
32 bits of information. (A bit is a single binary digit - 
basically a one or a zero). What these bits actually 
represent depends on the program running at the 
time. Data registers are normally used for manipulating 
data in the form of bytes, words and long. words - 
these being 8, 16 and 32 bits long respectively. 


Address Registers 
There are 9 address registers named AO to A7. A7 
is sometimes known as the stack pointer or SP 
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register What about the other address register then? 
The nineth address register is a duplicate of A7 and Is 
the SSP or Supervisor Stack Pointer When coding the 
chip, you only have access to 8 address registers at 
any one time - you are either using the SP or SSP 
version of A7 but never both at the same time. 

Address registers are normally used to hold 
memory addresses, stack pointers etc and cannot be 
used for byte sized manipulations. 


Status Register 

The status register holds a list of flags to tell the 
processor what is happening or has happened inter- 
nally. The status register is a 16 bit register in two 8 bit 
halves. The user byte ts held in bits 0 to 7 (the lowest 
end) and the system byte is held in the upped half or 
bits 8 to 15. The layout is as follows, first the system 
byte: 
meas [ia 2 oh eu lets ~ 
‘T is the trace flag - this defines whether the 
processor is in ‘single step’ mode or running normally. 
lf set to 1, the processor is tracing and if 0, is running 
normally, 

'S' is the supervisor flag - this defines whether the 
code being executed is running in user or supervisor 
mode. If set, the processor Is in supervisor mode 
otherwise It is in user mode. 

‘lll is the interrupt mask and represents a value 
between O and 7 and indicates which of the seven 
interrupt levels are enabled. 


The other bits are not used. 
Then the user byte : 


Bit 7 6 5 4 3 2 1 a 


The user byte contains the 5 condition code flags 
which are set or reset by certain instructions and then 
used by arithmetic or comparison instructions. The are 
used {o tell later parts of a program what happened 
recently. The program can adjust its operations to suit. 
The flags are: 

’X’ is the extended flag. Which is very similar to the 
'C’ flag bit ts affected by fewer instructions than 'C’ is. 
This is used when carrying out very large sized 
arithmetic instructions - such as 64 bit adds, for 
example. When affected it is set exactly like the 'C 
flag. 

'N’ is the negative flag. It gets set to 1 if the last 
instruction created a negative number. 

Z is the zero flag and is set to 1 if the last 
instruction generated a result of zero. 

‘V' is the overflow flag and is set to 1 #f the last 
instruction generated an overflow during 2's comple- 
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ment arithmetic. See later for details. 

'C’ is the carry or borrow flag. And is used when a 
subtraction operation is carried out - be it an actual 
subtraction or an implied one. 

The flags are used by the branch on condition (Bcc) 
instructions, the Decrement and branch (DBcc) 
instructions or the Set (Scc) instructions. These will be 
explained later. 


Program Counter 

The program counter does just that, it keeps track 
of where exactly the processor is within a program. 
The program counter always points to the address in 
memory of the next instruction to be executed. The 
program counter can of course be changed by a JMP 
(jump) instruction or a BRA (branch) but it is always 
ready with the next instruction to be executed. 


Adaressing Modes 

The 68000 has a large number of addressing 
modes and these can often become overwhelming to 
a new machine code programmer - | know. It takes 
some time to understand each and every mode, what 
it does and why it is used. Having said that, you do 
not need to remember all of their names, just what 
they look like in source code and of course, what they 
do. 

From here on, you ned to be aware that numbers 
may be in decimal format or hexadecimal. All hexade- 
cimal numbers are prefixed with the dollar sign ($) and 
wherever this is seen in front of a number (or in some 
cases, what appears to be a word) will be a hexadeci- 
mal number. (! will assume that you are familiar with 
hex. Editor's note: it has been explained in QL Today 
Issue 6 Volume 1 "Hardware or not Hardware") A 
couple of examples of hexadecimal numbers are: 

$100 

$COFFEE 

which are equivalent to 256 and 12,648,430 respec- 
tively. Without any further hesitation, lets dive right in 
with the addressing modes ... 


Register Direct 

This is an easy one to start off with. Register direct 
addressing mode simply means that both the source 
and the destination in the instruction are registers 
either data, address or a mixture of both. 

Simple examples are : 
MOVE.L A2,Di 
MOVE.W DO,D1i 
MOVE.L A1,A3 

These simply move (actually, they copy) data bet- 
ween various registers. The full meaning of the actual 
instructions will be described later on. 
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Absolute 

In this mode, the operand of the instruction is simply 
a memory address. This is also quite simple. For 
example io ‘zeroise’ the contents of the first byte of 
screen memory (assuming a standard QL and this is 
the last time that | will assume anything!) : 
CLR.B $20000 


There are two variations to this mode, absolute 
short and absolute long. If the address given is a 16 
bit word (ie O to 7FFF hex or 32767 decimal) then it 
refers to addresses in the first 32K of memory. If the 
address given is 8000 hex or 32768 decimal and 
upwards it refers to address FFFF8000 and upwards 
due to sign extension of the address word. This is 
absolute short, best used for addresses of 0 to 7FFFF 
hex only - to avoid confusion. 

MOVE.L $1000,D1 - gets the long word at 
address $1000 

MOVE.L $9000,D1 - gets the long word at 
address $FFFF9000 


The other variation is absolute long, in this case, the 
address given is a full 32 bits long and refers to the 
actual address in memory - there is no ambiguity with 
absolute long. 

MOVE.L $123456,D1 - gets the long word 
at address $123456 


Relative 

This mode will probably be the most used with QL 
programs as all code should be relocatable. This 
means that it never assumes that it is running at a 
specific location in memory. Some early QL programs 
were written to run at a specific location in memory 
and this caused no end of problems when memory 
expansions became available. | think Psion chess was 
one of the guilty ones. 

However, relative addressing simply means, relative 
to where the program counter is. The program coun- 
ter is always pointing at the address of the instruction 
in memory after the current one. An example of 
relative addressing is this small loop and the jump 
back to the start of the loop: 


Start MOVEQ #1000,D0 
Loop SUBQ #1,D0 
BNE.S Loop(PC) 


This is a small and totally useless fragment of code. 
The relative address mode is in the BNE.S LOOP(PC) 
instruction - it says - branch to the label called loop, 
relative to where the program counter is currently 
pointing, if the result of the subtraction was not zero. 
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The jump is specified in the code as a negative 
number, not the actual address of where the label 
‘loop’ is at. 

This negative number (in the example above) is how 
many bytes are to be added to the program counter 
to get the address of the next instruction to be execu- 
ted. The jump can be forwards as well as backwards. 
Using relative addressing means that the program can 
be loaded anywhere in memory and still work. If abso- 
lute addressing was used, the program would always 
have to be loaded at the same address if a crash was 
to be avoided, 

The example above is the equivalent of the 
following SuperBasic code : 

1000 REMark Start 

1010 LET DO = 1000 

1020 REMark Loop 

1030 LET DO = DO- 1 

1040 IF DO «> O THEN GOTO (1040 - 10) 


Address Register Indirect 

This mode is called ‘indirect’ because the address 
register in question is not the operand in the instruc- 
tion. It simply serves as a pointer to the operand. In an 
earlier example we cleared out the first byte of screen 
memory by using absolute addressing like this: 
CLR.B $20000 

This instruction could have been carried out using 
address register indirect mode as follows: 

MOVEA.L #$20000,A1 
CLR.B (Al) 

All that this is doing is setting address register 1 
with the value 131072 (decimal) which is 20000 (hexa- 
decimal). It then clears out the first byte at that 
address. This is the same as this SuperBasic example: 
1000 LET Al = 131072 
1020 POKE A1,0 


The registers name is put in between a pair of 
brackets to signify that it is the memory address held 
in the register that will be acted upon and not the 
register itself. 


Register Indirect With Displacement 

This mode is similar to the above, except that a dis- 
placement is added or subtracted from the address 
register to give the final address to be operated upon. 
Using the above example again, we can zeroise the 
first 4 byes of screen memory as follows : 
MOVEA.L #$20000,A1 
CLR.W (Al) 
CLR.W  2(A1) 

This time we use word sized operations, these 
simply affect 16 bits instead of 8 as with the byte 
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sized operations. The displacement is the number out- 
side of the brackets and it is added to the address 
registers contents to create the address to be opera- 
ted upon. The displacement can be any signed num- 
ber that will fit into 16 bits (32768 to +32767). 


Register Indirect With Displacement And Index 

It's starting to get complicated now. This is another 
mode where we have an address register and a dis- 
placement to consider, but this time we have an index 
as well. In this case the displacement has been 
reduced to 8 bits only giving a range of -128 to +127. 
The format of this addressing mode is : 

CLR.W 2(A2,A0.L) 

The contents of A2 is added to AO to get the first 
address then the displacement is added to give the 
final result. The 16 bits of memory at the final address 
is cleared out. (Like POKE_W A2 + AO + 2 0). 

In this case the entire 32 bit value of AO is added to 
A2, this is indicated by the ‘L’ after the second 
register - the index. If the suffix had been omitted or 
was 'W’. (which is the default if omitted) then the lower 
16 bits of AO would have been used instead of the 
whole 32. Take note that the 16 bits will be ‘sign 
extended’ to a full 32 bits and this can have 
unpleasant side effects if the value in bit 15 is a 1 as 
this will cause a negative index to be generated. 
There will be more on sign extension later. 

The first register specified is always treated as 32 
bit (L) and does not require a ‘.L’ suffix - most, if not all, 
assemblers will reject it anyway. 


Register Indirect With Pre Decrement Or Post 
Increment 

These addressing modes are used for stack opera- 
tions, usually The format of the pre-decrement 
instruction is : 
MOVE.L DO,-(A7) 


And for post-increment it is: 
MOVE.L (A7)+,D0 


HP-Deskjet UNDER CONTROL 


Wolfgang Uhlig 


No idea how to program your HP Deskjet printer? Do the control 
codes (if you ever found a description) confuse you? Wolfgang 
tells you how to drive your HP from BASIC or QD, for example. 


The actions carried out are as follows for pre- 
decrement: 

The value in A7 is decremented (reduced) by the 
size of the data to be stored (byte, word or long) then 
the contents of DO are stored at the location pointed 
to by AZ. 

In SuperBasic this equates to the following code 
fragment: 

1000 LET A7 = A7 - 4 
1010 POKE_L A7, DO 


The opposite action takes place with post-incre- 
ment, as follows: 

The contents of the memory address pointed to by 
A7 is copied into DO, then the address held in A7 id 
incremented by the size of the data just copied (byte, 
word or long). 

Again, this equates to: 

1000 LET DO = PEEK_L(A7) 
1010 Let A7 = AZ +4 


Immediate 

This is probably the simplest of all the addressing 
modes. It simply means that the data specifies the 
address value. For example: 
MOVE.L #100,D0 

This copies the value of 100 into data register 0. 
The hash sign indicates that the data is copied 
directly into the register Do not get confused between 
this instruction and: 
MOVE.L 100,D0 

Note that there is no hash. This instruction means 
load the CONTENTS of address 100 into register DO. 
This is not the same! This is a good source of 
confusion for beginners - | know all about it, and 
sometimes still make this mistake! 


The next part will deal with the instruction set. 
x 


be programmed from BASIC or to 
integrate into an editor (in my 
case: QD). 

This wasn't quite so easy: along 
with my 690C came a beautiful 
small book with lots of tips and 
tricks for WIN95, lots of advertise- 


When | bought my Deskjet 
690C | soon got very dissatisfied 
with what | could get out of it 
using the HP printer-driver for 
Text87plus4, my favourite word 
processor on the QL (QXLQPC, 
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whatever). This printer-driver pre- 
tends to support more fonts than 
the HP 500 actually has - but 
prints the ones there not in all the 
possible widths and heights! 

So | tried to find out what could 


menis for Hewlett Packard pro- 
ducts and so on but unfortunately 
not a single line of printer com- 
mands. The only very small hint | 
could find were the names of the 4 
built-in fonts and the possible 
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height and width of them, which -in 
the end- appeared to be rather 
important. 

A friend of mine had an older 
manual of an HP 500, in this 
manual there were printer com- 
mands: a start! 

After a couple of telephone calls 
with the HP help-line in Amsterdam 
- the people there are really very 
friendly and helpful, but they are 
completely unable to imagine that 
there are people with anything 
other than Windows: even for 
DOS there are still ‘drivers’ 
available!? - | finally got two other 
manuals, one was the HP-PCL, 
GL/2 and RIL Tables for Laser 
printers and the other one was a 
Printer Command Comparison Ta- 
ble for all HP printers. 

What I've found out is that we 
(QLers) can use HP printers very 
well except for colours. I've tried a 
lot, but up to now | have not had 
any success at getting my printer 
to print in colour So, if anyone 
knows a solution for this: please 
write to me and/or to QL- Today! 

Getting HP printers to print 
exactly what you want them to is 
not as easy as it is with Epson 
printers. 

The PCL (Printer Commands 
Language] commands are longer 
than Epson commands AND have 
to be given in a special order 
(which by the way is not very 
logical) AND you have to take 
care of the values for width and 
height AND not all heights go 
together with all widths (and vice 
versa) AND italic doesnt go 
together with some heights or 
widths AND italic doesn't go to- 
gether with Letter Gothic anyway 
AND proportional has other 
heights than non-proportional 
AND .. 

You see, it is not at all difficult to 
get strange results. 

When testing the commands, | 
found it very annoying that there 
is no chance to test different com- 
mands on one page and look at 


22 


the result immediately, because 
the printer doesn't begin its work 
before you've given a Form Feed 
Command or before the ‘pagebuf- 
fer’ is full Thus you waste a lot of 
paper with only some lines of text 
on tt. 

After all that “frustration” now the 
good news: if it all works, it works 
fantastically well 

In the following examples, il 
give the commands in two ver- 
sions, one with CHR$(27) which is 
the start of any HP command fol- 
lowed by a combination of letters 
and numbers. The other with 
BPUT and the decimal values of 
the above mentioned letters and 
numbers. 

The most important commands 
(in the form of a BASIC-program)} in 
the correct order are: 


Open the print channel 
100 OPEN #3,par 


Printer reset 
120 BPUT #3,27,69 
Or PRINT #3, CHR$(27)&"E" 
Line _ termination _ command, 
absolutely necessary! 
130 BPUT #3,27,38,107,50,71 
Or PRINT #3, CHR$(27) &"&k2G" 


Portrait_or landscape: portrait is 
default, for landscape change the 


last but one number to "49' or ‘1’ 
respectively. 
140 REMark BPUT #3, 27, 38, 
108,48, 79 
Or REMark print #3,CHR$(27) 
&"&100" 

{Achtung: Null und Buchstabe 
O, nicht Doppel-Null!] 


Spacing: proportional has priori- 
ty, which means, if you choose 
proportional, you won't be able to 
print Courier (or Univers. with 
690C) because they are [fixed 
spacing fonts. Here, proportional is 
ASCIl '49° or decimal ‘1’ and fixed 
spacing is '48' or ‘0’ 


150 BPUT #3,27,40,115,49,80 
Or PRINT #3, CHR$(27)&"(siP" 


Pitch (characters/inch): only for 
non-proportional of course. Take 
care: depends on font and height 
of it and above, whether it is italic 
or not. 

160 BPUT #3,27,40,115,50,52,72 
Or PRINT #3,CHR$(27)&"(s24H" 


Height (in points): same pro- 
blems as before 
170 BPUT #3,27,40,115,49, 50,86 
Or PRINT #3,CHR$(2'7)&"(s12V" 


Style: Upright is ASCII ‘48° or 
decimal '0’ italic is ’49' or ‘1’ 
180 BPUT #3,27,40,115,48,83 
Or PRINT #3, chr$(27)&"(s0S" 


Stroke weight: normal is ASCIl 
‘48’ or decimal ‘0’ bold is ASCII ‘51’ 
or decimal ’3’ 

190 BPUT #3,27,40,115,48,66 
Or PRINT #3,CHR$(27)&"(sOB" 


Woelace family: 
1. COURIER 


200 BPUT #3,27,40,115,51,84 
Or PRINT #3,CHR$(27)&"(s3T" 
2.CG TIMES 
210 BPUT #3,27,40,115,52,49, 
48 49,84 
Or PRINT #3,CHR$(27)&"(s4101T" 
3. LETTER GOTHIC 
220 BPUT #3,27,40,115,54,84 
Or PRINT #3,CHR$(27)&"(s6T" 
4. UNIVERS (not with HP 500) 
230 BPUT #3,27,40,115,53,50,84 
Or PRINT #3,CHR$(27)&"(s52T" 


Now you can write your text or 
whatever you want to print: 
240 PRINT #3,"this is mytext" 


FORM_FEED: is necessary to 
force a print out 
250 BPUT #3,12 
Or PRINT #3,CHR$(12) 


Close printer channel 
260 CLOSE #3 
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TE Services 
OL RomDisq 


Up to 8 mbyte of flash memory for the Sinclair QL 
NOW BEING SHIPPED 

A small plug in circuit for the QL’s ROM port (or 

Aurora) giving 2, 4 or 8 mbytes of permanent FLASH 

memory (ie there when the QL is switched off) which 

can be written to by the QL. 


superHermes 


A major hardware upgrade for the a 
* All Hermes features (see below for list) PLUS 19200) 
Le he on serl/ser2 not affected by sound 
* IBM AT keyboard interface (plus foreign drivers) __ 
* HIGH SPEED RS232 industry standard two-way serial port. 
4800cps throughput (supergoldcard - qtpi - zmodem) at 
57600) 


low speed RS232 in (1200 to 30bps) Driver fo 
SERIAL MOUSE pian Ones uses include RTTY; 


hics tablet etc 
2 THREE e I/O lines (logic) with GND/45V 
° Capslock/scrollock LED connector 
* Turbo/keylock connectors 
* 1.5k user data permanently storeable in EEPROM 


All this on a professional board about twice the size of 


The software to access it is loaded automatically at 
power up/reset. It uses a directory driver written by 
Tony Tebby, and logic code from Stuart Honeyball. 
You can even load ROM images. 


the 8049 co-processor it replaces 
Cost (including manual/software) £90 (£92/£87/£90) 
£22 (£24/£23/£27) 
£11 (£13/£12/£14) 
Capslock/scrollock LED £1 (£1.50/£1/£1.50) 
Keyboard or mouse lead £3 (£3.50/£3/£3.50) 


High speed serial (ser3) lead....... £4 (£4.50/£4/£4.50) 


Hermes available for £25 (£26/£24/£27) Working ser1/2 
and independent input, debounced keyboard & keyclick. 


superHermes LITE 


All Hermes features (see above) + an IBM AT 
keyboard interface only. Entry level superHermes. 
Cost (incl keyboard lead)...£53 (£55.50/£5 1/£53.50) 


MINERVA RTC (MKII) + battery for 256 bytes ram. 
CRASHPROOF clock & I’C bus for interfacing. Can 
autoboot from battery backed ram. Quick start-up. 


The ORIGINAL system operating system upgrade 


OTHER FEATURES COMMON TO ALL VERSIONS 
DEBUGGED operating system/ autoboot on reset of power 
failure/ Multiple Basic/ faster scheduler- graphics (within 
10% of lightning) - string handling/ WHEN ERROR/ 2nd 
screen/ TRACE/ non-English keyboard drivers/ “warm” 
fast reset. V1.97 with split OUTPUT baud rates (+ Hermes) 
& built in Multibasic. 

First upgrade free. Otherwise send £3 (+£5 for manual if requd). 
Send disk plus SAE or two IRCs 


| MKI..£40 (£41/£40/£43) MIKEL..£65 (£66/£63/£67) 


QL REPAIRS (UK only) 


Fixed price for unmodified QLs, excl microdrives. QLs 
tested with Thorn-EMI rig and ROM software. 


£27 including 6 month guarantee 


Think of it - you could fully boot an expanded OL, 
including all drivers/SMSQ etc off RomDisq at hard 
disk speed (reading at over Lmbyte per second). 


It is an extremely small and compact circuit board, and 
has hard gold edge connectors, eliminating contact 
problems and corrosion. 


£39 (£41£37/£40) 
£65(£66/£63/£67) 
£98 (£100/£95/£99) 
£3 (£3.50/£3/£4) 


I2C INTERFACES 
Connects to Minerva MKII and any Philips I°C bus 


Power Driver Interface 16 V/O lines with 12 of these used to 
contro] 8 current carrying outputs (source and sink capable) 
2 amp (for 8 relays, small motors) £A0 (£43/£38/£44) 
4 amp total (for motors etc) £45 (£48/£43/£50) 
Relays (8 3a 12v 2-way mains relays (needs 2a power 
driver) £25 (£28/£23/£27) 
Parallel Interface Gives 16 input/output lines. Can be 
used wherever logic signals are required.. £25 (£28/£23/£27) 
Analogue Interface Gives eight 8 bit analogue to digital 
inputs (ADC) and two 8 bit digital to analogue outputs 
@AC). Used for temperature measurements, sound 
sampling (to 5S KHz), x/y plotting..... £30 (£31.50/£29/£30) 
Temp probe (-40°C to +125°C) £10 (£10.50/£10/£11) 
Connector for four temp probes £10 (£10.50/£10/£11) 
£2 (£2,50/£2/£3) 
Control software & manual (for all I/F) .. £2 (£2.50/£2/£3) 


£12 (£12.50/£12/£13.50) 
£3 (£3.50/£3/£4) 

£3 (£3.50/£3/£4) 
£8.50/£7.50/£9) 


68008 cpu or 8049 IPC £8 ( 
8301/8302 or JM ROM or serial lead.. £10 i 1.50/£10/£1 13 


Power supply (sea mail overseas) £12 (£17/£16/£21 
Other components (sockets etc) also available 


Prices include postage and packing (Airmail where applicable). Prices are: UK (EC,/Europe outside EC/Rest of world). Payment by cheque drawn on bank with 
card/Mastercard/Access/Eurocard/; 


UK address, debit 


postal order or CASH! (No Eurocheques). SAE or IRC for full list and details 


8 MAR 96 


29 Longfield Road, TRING, Herts, HP23 4DG 


VISA Tel: 01442-828254 


Fax/BBS: 01442-828255 


| | tony@firshman.demon.co.uk — http://www.firshman.demon.co.uk 
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According to the HP-manual (HP 
500) the command for stroke 
weight has to be sent in the cor- 
rect order (see above} but it 
seems to be no problem if you 
send it alone in order to make a 
single word or a sentence bold for 
example. 

The commands for underlining 
are independent from order rules. 
You have four sorts of underline: 
single fixed, single floating, double 
fixed and double floating, the latter 
two being really very attractive. 

Here the commands: 

single fixed: 

27, 38,100, 49, 68 

Or CHR$(27)&"&d1D" 
single floating: 

27, 38,100, 50, 68 

Or CHR$(27)&"&d2D" 
double fixed: 

27, 38,100, 51,68 
Or CHR$(27)&"&d3D" 
double floating: 

27, 38,100, 52,68 

Or CHR$(27) &"&d4D" 
disable underline: 

27, 38, 100, 64 

Or CHR$(27)&"&de" 


Related to the height of the 
fonts, if may be interesting to alter 
the line spacing. The command for 
that Is: 

27, 38,108, #..#, 68 
Or CHR$({27)&"&1#D" 

whereby ‘#' is a number out of: 
1,2,3,4,6,81216,24,48 and ‘2.4 the 
decimal value(s) of this number. It 
means: # lines per inch 

So for example 
27, 38, 108, 54,68 
Or CHR$(27)&"&16D" 

means: 6 lines per inch (default) 
and 
27, 38,108, 50, 52, 68 
Or CHR$(27)&"&124D" 

means 24 lines per inch (which is 
very narrow) 

Sometimes you want to print in 
columns but you would like to do 
this writing with a proportional 
font. Then you will have to position 
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the (virtual) cursor horizontally. For 
example, if you define: 
tab1$=CHR$(27)&"&a40C" 
tab2$=CHR$(27)&"&a80C" 

(40 and 80 being at your choice) 

then 
PRINT #3,a$; tab1$;b$; tab2$; c$ 

will print a$b$.c$ in three 
columns. 

To get the right position, you 
must experiment a little, surprising- 
ly the HP 500 and the 690C give 
different results on the same ‘TAB’ 

Of course everything only 
works with TRA 3 (SMSQE) or 
with IBM_TRA on Minerva. or 
others. 


From BASIC the BPUT com- 
mands are most comfortable (ex- 
cept for the ‘TABS’. With a little 
testing you can design fantastic 
pages! 

From within QD or other editors 
that will accept CHR$(27), the 
string-commands offer an interest- 
ing possibility of formatting a text. 
You could give your preferences 
first, then write your text. Within 
the text you can swap stroke 
weight or change to underline and 
back, you can play with different 
heights, italic and so on. 

Simply write one of the above 
described commands where 
CHR$(27) has to be the unprint- 
able ESC-code. In QD you find this 
one in the code-table. That looks a 
little bit strange (CHR$(27) is ' @’ in 
QD), for example: 

This is normal text, 2(s3B now 
its bold and 2&d3D now it's dou- 
ble underlined, too .... but it works 
fine. Of course you have to take 
care of what you write in the 
printer preamble of QD. 


The fonts can be printed in the following combinations: 


COURIER: 5, 10, 16.67, 20 cpi 
italic 5, 10, 20 cpi 
CG TIMES: proportional 
LETTER GOTHIC: 6, 12, 24 cpi 
LETTER GOTHIC: 16.67 cpi 
UNIVERS: proportional 


(| don't know whether this is also 
possible in Quill because | haven't 
used it for years, Text87plus4 
won't accept CHR$(27)) fit might 
be possible if you use a translate 
sequence to convert an unused 
character to be outpuf as 
CHR$(27) instead - Editorl 

As already said, I've tried to print 
in colours, | even have found a 
command for that, but up to now it 
refuses to work correctly. 

lf anyone is interested in a small 
PE printer driver for HP 500/690 in 
which most of the above features 
can easily be arranged by simple 
mouseclicks, he/she should get 


- point 6, 12, 24 


- point 5, 6, 7, 8, 10, 12, 14 
- point 6, 12, 24 

- point 4.75, 9.5, 19 

- point 5, 6, 7, 8, 10, 12, 14 
- italic 5, 6, 10, 12 point 


my “HP-Driver_zip’ from Jochen 
Merz’s BBS. In it there is the Basic- 
sourcecode, the menu, created 
with the EASYPTR-suite, one 
version compiled with and another 
without runtimes, this text and a 
small text concerning the Basic 
program itself, You can get every- 
thing, also apart, from me by 
e-mail, too. 

And now, have fun with your HP 
printer! 

Email: wolwol@compuserve.com 


Still no hot 
tie tent? 
Wheie’s 

y lenty of 


QLAY 0.85 - First Look & More 


Al Feng 


Jan Venema (hitp:/www.inter.nl.net/hcc/A.JawVenema) recently 
made a new version of QLAY available (03 May 1998). QLAY is a 
freeware QL emulator and Al has had a closer look at the recent 


version for you. 


QLAY is a freeware QL emulator: 
and with the help of others, | re- 
ceived a copy of the most recent: 
ly posted ZIP files -- first, version 
0.84; and subsequently, QLAY 0.85. 
For all practical purposes, QLAY 
requires a 486-or-better running at 
66 MHz or faster with 8 Meg of 
memory, The emulation creates a 
640K QL. 

The most recent release of 
QLAY actually comes in two ver- 
sions - the traditional DOS pro- 
gram and one that can be 
launched directly from within 
WINDOWS 95. 

That's the good news. The bet- 
ter news is that Jan Venema has 
indicated that he ts already work- 
ing on the next version and it 
should be ready by the time you 
read this. 


QLAY 0.85a 

The DOS based code functions 
in a manner similar to the previous 
versions. First you load the 
CWSDPMLEXE file, and then the 
QL code and extensions are loa- 
ded, and then the NFA (Native File 
Access) code is loaded. The NFA 
code give QLAY the ability to 
access the host PC’s hardware 
and is a remarkable piece of 
coding. 

Depending on the speed of your 
computer the code Is processed, 
and then the emulation begins. 

The obvious change is the 
inclusion of the QLAYRC file. This 
fle is an ASCIl script which ts 
essentially a dedicated BAITCch file 
which both version 0.85a & 0.85b 
look for when the EXEcutable file 
is loaded. This is how the (stock) 
QLAYRC file looks: 


QL foday 


-r js.rom 

-c c000@nfa. rom 

-f 1000 

The syntax appears to be just 
different enough that | was not 
able to successfully load the 
TK2_EXTensions on the first 
several tries. 

| finally e-mailed Jan Venema to 
get the proper’ syntax: 

-r js.rom 

-c 0c000@f:\tk2.ext 

-c c0000@f:\nfa.rom 

-d 2 

The new version comes with an 
image of the Dynamic RAM code; 
but, | have not been able to load it 
to date. This code (or, similar} is 
necessary if you want to use the 
XCHANGE program which sets up 
temporary files in RAMI1_. 

All other tested programs ran, 
including the TURBO compiler. 

Exit the emulation via CTRL- 
ALT-DEL key combination when 
loaded from within WIN95. 

To exit from a plain DOS load, | 
believe you have to reset the 
computer 


QLAY 0.856 


For reasons that are always sus- 
pect, | upgraded my IBM compat 
ble PC recently and the OS with a 
copy of WIN95. While subjecting 
myself to the OS upgrade was 
semr traumatic (ie. | inadvertently 
wiped out all my files!), having 
WIN95 allows me to give the new 
QLAYWEXE {aka QLAY 0.85b) a 
try The QLAYWEXE is designed 
to run directly from either a WIN95 
icon or from the WIN95 DOS 
prompt. 

When you load QLAYWEXE, you 
will see a modest window with the 


following options: File, Screen, 
Language, Help. 

Using the ‘File’ selection, you 
essentially verify (or load?) the 
equivalent of the CWSDPMIEXE 
code by selecting ‘Init!. You then 
select ‘Go!’. Very shortly after that, 
you will see the familiar speckled 
screen followed by the QL’s 
Startup screen. 

| was not able to load an image 
of my MINERVA ROM code. | was 
told that this is only viable with the 
JSL1 (ie, older) code (which | 
have}. | have to presume that my 
MINERVA code file was corrupted 
in the transfer. 

Your language choice is English 
or German, with the default now 
being English. 

| believe that all my problems 
can be related to implementation 
of the QLAYRC file. 

lf your QL program uses ALT 
keys, then you will want to use the 
DOS version due to a key-stroke 
conflict which will exist with 
WIN95. 


HEY, | KNEW IT COULD BE 
DONE! 

Many of you may recall that one 
of my biggest complaints about 
SMSO [the OS used for the QXL & 
QPC emulators] is that it the dis- 
play that is generated is less than | 
think it could be. 

Jan Venema modestly states 
that ‘the Windows95 version has 
better display support.’ 

With the WIN95 version of QLAY. 
Jan Venema has demonstrated 
that the display is not only scale- 
able, but that it can be done in an 
efficient manner. In version 0.85b, 
the screen can be selected before 
the emulation OR during the emu- 
lation. The five display sizes which 
he has provided are: 

Size 1: 512 x 256 

Size 2: 512 x 341 

Size 3: 768 x 512 

Size 4: 1024 x 683 

Size 5: 1024 x 768 
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The great news is that ‘Size 3’ 
actually fills the usable screen 
space (9.5°x6./5°; or about 11.75" 
diagonal on a 14° VGA monitor). | 
have to mention that the first 
several times | switched to ‘Size 3° 
that it was just a little larger than 
the available screen space. Initially, 
| would estimate that ‘Size 3° was 
being displayed as one line higher 
than a normal screen, and one 
character wider. 

This over-fill stopped after | ad- 
ded the CWSDPMIEXE file to the 
same directory as the QLAYWEXE 
program. Coincidence? I'm not 
sure. | haven't removed the file to 
verify this. 

‘Size 4 & ‘Size 5’ definitely 
over-fill a standard VGA screen. 

‘Size 1' is similar to the image 
created by SMSQ, but the vertical 
is slightly compressed due to the 
‘top line’ being occupied by the 
control bar (7.5°x3.75’), 

‘Size 2’ Is taller than the standard 
QLAY (0.85a) display and the 
SMSQ display (7.75°x5’) 

The font quality varies, with the 
font created in ‘Size 3’ as best 
described as being a compromise 
(1/4’ font height). The font in ‘Size 
1’ & Size 2’ are similar to CSIZE 
0,0 (1/8 & 3/16" font height, 
respectively); and, the font in ‘Size 
4 & ‘Size 5’ appear to be similar to 
CSIZE 21 (5/16° & 3/8" font height, 
respectively). 

As one might suspect, there is a 
price to pay for the scalability of 
the screen display with the larger 
displays using more of the host's 
resources. Ergo, the larger the 
display selected, the slower the 
emulation. 

As | mentioned, the size can be 
switched at any time during the 
emulation when using version 
0.85b; so, the smaller size can be 
selected when greater speed is 
required, and to the full screen 
mode at other times. 
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TASK SWITCHABLE 

Both versions are easily task 
switchable from within WIN95 by 
using either the ALT-ESC or the 
ALT-TAB key combination; or the 
pointer arrow with QLAYWEXE if 
your task bar is visible. 

Of course, use the CTRL-ESC 
key combination to load other 
programs; or the pointer arrow 
with QLAYWEXE. 

QLAY 0.85b is unstable if other 
programs are dormant in the 
background; but, Venema assures 
me that this problem will have 
been fixed with subsequent relea- 
Ses. 


MINERVA COMPATIBILITY 

Only the older (JSL1) MINERVA 
code works. Even so, | was not 
able to load the MINERVA ROM 
image that | made. | will try this 
again at a later date. 


QLAYT 

QLAYTEXE is currently an 
essential DOS utility for effectively 
using QLAY. 


The QLAYTEXE is found on ear- 
lier ZIP files, so you should ensure 
that if you are downloading from 
Venema's web site. 

There is a QLAYT program 
which | believe is for use with 
LINUX, and this should not be 
confused with the QLAYTEXE 
program. 

QLAYT allows you, first and 
foremost, to add programs to the 
active directory file (QLAYDIR). 

With the anticipated addition of 
QDOS floppy access, you should 
be able to add files to your hard 
drive directly from floppy. 

The most important thing to 
know ts that if you want to INSERT 
a file into the QLAY dir the DOS 
syntax is as follows: 

C:\ QLAYT -i QLATter -d 31790 


QLAYT switches are case sensi- 
tive. Note the file being inserted 
into the existing QLAYDIR file is 


"QLATter’ which has a size of 
‘31790 bytes’. The file size on 
some files does NOT need to be 
declared. 


LIMITATIONS 

Some of the documentation pre- 
sumes you know more than | do. 

The QLAYRC file requires the 
syntax be written a bit differently 
than in the past. 

TK2_EXTensions must be provi- 
ded by the user 

QLAYWEXE is designed to run 
without the CWSDPMIEXE file, but 
it appears to be more stable when 
it is accessible by the QLAYRC file. 

Sub-DiRectories are not current: 
ly supported. 

While | don’t know how to use 
the virtual "mdv’ drives for storage 
(this is probably something that | 
should learn how to do in the near 
future because | believe these can 
be used as effective substitutes 
for sub-DiRectories), and QLAY’s 
/0 is still limited, 

While floppy access should be 
implemented by the time you read 
this, QLAY still does not have 
SERial access; but, presumably 
this will be a future function. 


WHY QLAY? 

| have been told that there is 
another freeware, QDOS emulator 
(WinQL -- written by the author of 
the emulator that runs on the 
68000-based MACs): but. | haven't 
seen a copy, yet: so, | do not know 
what limitations exist with it (if any). 
[Do you mean Q-EmuLator? - 
Editor] 

The question that | am sure that 
some people will ask is “Why 
would | want to use QLAY?’ (or, any 
other emulator}. 

There are actually reasons that 
QLAY. as tested, is more than ade- 
quate for most people who need 
to use a QDOS emulation. 

The fact that files are created 
saved fo your hard drive in DOS 
format may be a benefit for some 
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Worldwide Membership is by subscription 
only, and offers the following benefits: 
Monthly Newsletter - up to 40 pages 
Massive Software Library - All Free ! 
Free Helpline and Workshops 
Regional Sub-Groups. One near you? 
Advice on Software and Hardware problems 


Subscription just £14 for UK members 
Overseas subscription £17 


Barclaycard: Visa: Access: Mastercard 
* Now in our FIFTEENTH successful year * 


Further details from the Membership Secretary © 


Bill Newell 


213 Manor Road ice 
Benfleet mal 
Essex 


SS7 4JD 
Tel. (01268) 754407 
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Native 68k 


Some speed comparisons 


System/CPU print function String Configuration/Emulator 
QL original 980 840 1100 128k, JS-ROM 

SandyQL 1080 1040 1360 512k, Floppy, Par Port 
GoldCard 2580 4280 5680 

Super GoldCard 5680 10260 13820 

Amiga 68040/25 9480 16540 23000 AmigaQDOS (JS/3.24) 
QXL-20 14300 27900 70640 

Amiga 68060/50 10480 48750 73880 AmigaQdos 3.24 Beta (Blitter) 
Emulated 68k 

System/CPU print function string Configuration/Emulator 
486/DX2-66 660 980 1300 QLAY081 -d2 (DOS) 
486/DX2-66 1080 1360 1820 QLAY082 -d2 (DOS) 
486/DX2-66 920 1440 1840 QLAY083 -d2 (Linux) 

Amiga A1200 2500 1800 2000 QL emulator, with 68060/50MHz 


Pentium/150 2360 


CyrixPR200MMX 3780 


CyrixPR200MMX 3020 
CyrixPR200MMX 2560 
CyrixPR200MMX 2340 
CyrixPR200MMX 1920 
CyrixPR200MMX 1900 


6000 
5260 
7120 


PentiumPro/200 
Pentium/200 
Pentium/150 


people because it eliminates the 
file conversion step. 

For example, | recently prepared 
a manuscript which began in Quill 
but which | later imported into 
WORKS for formatting and print- 
ing; and, | was glad for the better 
fonts available through WINDOWS 
(having said that, | have to admit 
that | have not used or seen any 
of the output generated by the 
programs from PROGS;: so, | don't 
know what | am missing with 
regard to QL-to-printer output). 

lf you have a proprietary pro- 
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3680 4960 


5800 7240 
4860 6120 
3640 4560 
3280 4100 
2540 3180 
2500 3100 


8000 11000 
9340 12660 
10840 28120 


gram that was written to run on 
QDOS, you no longer need to be 
concerned with porting it over to 
run on a PC since you can simply 
run it using the QLAY emulation. Or 
for example, if you do not have 
the PC version of the PSION Suite, 
but prefer to use DBEasy {as | do} 
for your database needs, then 
QLAY will allow you to continue to 
do so. 

lf a program will run on a stan- 
dard QL, then more-than-likely, it 
will run with the QLAY emulation; 
but, the exception might be older 


QLAY082 


QLAY085a 
QLAYW085b size 1 
QLAYW085b size 2 
QLAYW085b size 3 
QLAYW085b size 4 
QLAYW085b size 5 


QLAY082 -f2900 
QLAYW085 size 1 
QPC 


games which require a key. 

Unlike the QPC emulator, all 
versions of the TURBO compiler 
work. 

Unlike the QPC emulator QLAY 
is (currently) freeware. 

All in all | think that QLAY is 
excellent QDOS emulator for a 
person with a suitable host PC 
who has a need to access 
existing QDOS programs and files. 


HAPPY TRAILS, AND 
COMPUTING, TO YOU .... 
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The 1998 USA QL Show 


John Impellizeri 


You haven't been to a QL show in the USA? Definitely a mistake! 
This year's show was very well attended. If you read this review 


and hear about the plans for next year’s show (... 


more on this in 


a few months) then you may find that it's the right time to save 
your money for a flight to the USA next year. 


On Saturday, May 23rd, the sixth 
US QL show was held once again 
in Bedford, Pennsylvania, the same 
place as last year’s show. Held in 
the banquet room of the Carriage 


inn restaurant, by all accounts the 


show was another | 
success. Traders 
present included § 
the show's organr § 
zers, Frank and fee 
Carol Davis of FWD 
Computing, Jochen a 
Merz of Jochen @e 
Merz Software, @ 
Tony Firshman ol 
TF Services, Roy § 
Wood of QBranch, § 
Albin Hessler, Paul 
Holmgren, Francois 
Lanciault, Zeljko 
Nastasic (Nasta of 
Qubide and Aurora 
fame), Bill Cable of 
Wood and Wind 
Computing, and the NESQLUG QL 
users group. Don Walterman repre- 
sented Quanta selling member- 
ships and Quanta merchandise. | 
brought a working copy of the 
QBox-USA BBS. 
While the official [i 

show wasn't until 
Saturday, things get 
going Friday night 
as everyone who 
has arrived in town 
gathers at the res- 
taurant for dinner, 
drinks and conver- 
sation. Friendships ; 
and acquaintances 
are renewed, new 
faces are intro- 
duced and the ex- 
cifement for the @ 
show really starts 7 
building. 
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Afterwards, and before it gets to 
be too late, the banquet room is 
opened to allow the traders some 
time to set up. 

Trying to get to sleep Friday 
night reminded me of Christmas 


eve as a kid, with lots of anticipa- 
tion for the next day. Saturday 
morning found the usual crowd 
waiting for the show to open. Not 
including traders, | counted about 


30 show visitors, not a lot but 
about the usual amount at the past 
few US shows. Its mostly the 


same people every year but i did | 


see a few new faces this year 
Unfortunately, | don't remember 
their names. | hope we'll see them 
again next year. 

From my viewpoint it looked like 
most of the traders tables stayed 
busy all day. Jochen was busy like 


always updating disks and promo- | 
ting QL Today. Back issues were 5 


available as was the new copy of 
volume 3 issue 1. Albin Hessler had 

my: saleS and up- 
, dates to Cue 
Shell and the 
EasyPfR series. 
Frank and Carol 
Davis had_ their 
wide range of 
QL and 288 
software and 
hardware. In ad- 
| dition they also 
had other types 
fof ‘software’: 
T-shirts and 
pads 


number of diffe- 
: rent QL and Z88 


tures along with a special show 
shirt. | waited too long and missed 
out on one of these. Roy Wood 
was also busy updating disks and 
selling all sorts of QL goods from 
his colorful new 
Catalog {pro- 
duced and prin- 
ted using QL 
e softwarel). 
| jony — Firshman 
had the new 


mes, and super- 
Hermes. Also on 
display were the 
Lego models 
| controlled by 
Minerva and |2C 
interfaces. | have 
fy read about these 
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Show Review 


at other QL shows but | believe this 
was the first time they appeared at 
a US show. Paul Hoimgren was 
there with boxes of alder Sinclair 
and Timex computer items. For 
those of us who started out with 
Sinclair ZX8is and Spectrums and 
Timex 2068s, this was a good 
chance to complete your collec- 
tion of older hardware, software 
and books. He 
had a pretty good 
supply of QL 
motherboards 
and spare paris 
too. 

NESQLUG, a 
Quanta sub- 
group, was there 
offering member- 
ships along with 
current and back 
issues of their 
very well done 
newsletter, Bill 
Cable of Wood - 
and Wind Compu- 
ting had available his line of soft- 
ware designed to make Psion’s 
Archive more friendly and easy to 
use. Don Walterman represented 
Quanta, signing up new members 
and selling some of the merchan- 
dise that is offered in the Quanta 
newsletter | 
brought along a 
working copy of 
the BBS and 
took care of any 
requests for cOo- | 
pies of PD solt- 
ware and share- 
ware. Not every 
QL user is ‘wired’ 
(access to the 
internet} or cares 
to call BBS’s, so 
this waS an op- 
portunity to get 
copies of some 
of this stuff 

One nice fea- 
ture, | feel, at both Ff 
last years and 
this year’s show is the ‘forced’ 
lunch. By forced | mean that at 
around noon, the show closes 
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(everyone is kicked out and the 
room is locked), and a buffet style 
lunch is served the cost of which is 
includec in the show admission. 
What's nice is that is was held in 
the restaurant where the show 
was held so there's no travelling. 
But the best part is that if you're 
anything like me, you can get so 
wrapped up in all things QL that 


you forget to eat and after a while 
you start to wonder what that odd 
pain is in your stomach and then 
you realize that it's hunger! 

As Is uSual there were a number 
of talks and demos throughout the 
day given by the various traders 


and developers. A change this 
year was to hold these in a diffe 
rent room so as not to compete 


with others trying to do business. | 
think this worked rather well. Nasta 
gave a talk about the Goldfire, the 
replacement for the Super Gold 
Card. He brought along a proto- 
type to show. A number of people 
wanted to buy it from him on the 
spot! It is a very impressive looking 
board, even for a prototype. Some 
of the reasons and decisions for 
iS various fea- 
tures were given. It 
| was a thrill for me 


== the flash memory 
fcard for the QL. 
FE Available in 2 meg, 
i 4 meg and 8 me- 
| gabyte versions, it 
iS very small, fast 
and just plain 
works! Depending on your needs, 
you could put all your software on 
it and just carry it around, plugging 
it into any available or borrowed 
QL which is what | think Tony did 
for the US show. 

Francois Lanciault showed Para- 
graph, a new word 
processor for the 
QL that he is deve- 
loping. It is not a 
m finished product 

» yet, but what he 
has so far looks 
very promising. It 
will run under the 
= PROWESS © win 


a have advanced 
» features such as 
tables and drawing 
tools in addition to 
the usual word 
F processing func- 
tions. | think there 
may have been a few other talks 


or demos but | missed them being 


busy copying files and trying to 
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get some of my own personal 
purchases and updates done. | 
apologize if | left anyone out. Last 
year Bill Cable, Al Boehm and Herb 
Schaaf all gave demos, maybe 
they did this year too? Sorry if | 
missed any of you guys. 

The show seemed to end too 
quickly (don't they always?!?} and 
we all had a little time to dismantle 
displays and go back to the hotel 
rooms to relax for a short while. 
Then we were back at the Car- 
riage House Inn to have dinner in 
the banquet room where the show 
was just held. With good food and 
drink and lots more conversation, It 
is a great way to end the day, 
although not everyone ends it 
here. Some of the talking and 


It could be You! 


Geoff Wicks 


drinking goes on until they kick the 
group out so they can close the 
restaurant. Others go back to the 
hotel to start checking out new 
purchases or to help with on-the- 
spot upgrades and repairs. Sunday 
morning finds most people in the 
hotel lobby enjoying the continen- 
tal breakfast and saying goodbyes 
and getting ready to depart. 

| think this year’s US show was 
another success, | certainly en- 
joyed it, and rumour has it that next 
year may be on two consecutive 
weekends, one perhaps in Bed- 
ford again and the following week- 
end in California to accommodate 
the QL users on the opposite side 
of the nation who can't always 
make it out east. | can’t wait! 


Geoff Wicks’ tales of horror with harddisk crashes. 


A giant finger points from the 
sky as a deep voice booms ‘It 
could be you’. 

UK readers will recognise this as 
the advertising of the National Lot- 
tery. Recently, when a giant finger 
was pointing in my direction, it was 
decidedly off-message. It was not 
telling me | was about to become 
Britain's next millionaire, but that | 
was next in line for a hard disk 
failure. Fortunately it was only a 
3-day wonder, but it could have 
been different. 

Our chances of a hard disk 
failure in the next year are far 
greater than those of winning a 
decent prize in any lottery, but we 
still continue to buy our lottery 
tickets and to neglect our hard 
disk maintenance. 

As computer users we have a 
naive faith in magnetic media. | 
learnt my lesson way back in the 
Spectrum days, when | bought 
some ‘own name’ tapes from a 
reputable department store. They 
caused many hours of frustration 
with aborted attempts to load 
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programs, lost data and frequent 
cleaning of tape heads covered 
with an oxide deposit. 

When disk drives took over | re- 
solved never to use cheap disks, 
because | knew that the tape 
heads of drives are less accessi 
ble and more delicate than those 
of cassette recorders. 

In his QL Today articles Mark 
Knight warns us against cheap 
disks and it is a warning | can re- 
inforce. If you ever have a floppy 
failure, do not throw the disk away. 
Open it up and have a look inside 
to see on what a flimsy thing your 
precious data is preserved. It will 
make you think twice about such 
practices as boring holes in disks 
to increase their capacity, 

Over the three years | have 
been running JUST WORDS! | 
have used more disks than the 
average QL-user will use in a life- 
time. About 2 years ago DD disks 
became almost impossible to ob- 
tain in the Netherlands, and | had 
to use what disks | could get. They 
were by no means the cheapest, 


but were a quality less than what | 
would ideally use. | am getting 
many of these disks returned as 
clients upgrade, and a high propor- 
tion have damage to the sliding 
shield that protects the magnetic 
surface. Some are no longer 
usable and go straight into the 
dustbin. As the Dutch say, {but 
don't always follow), “Goedkoop is 
duurkoop” or "Buying cheaply is 
expensive’. 

But back to my hard disk. My 
working QL system is a QXL card 
in a 286 PC. | took it over from a 
family member when she upgra- 
ded to a Pentium, who in turn had 
taken it over from another family 
member when he had upgraded. 
This is a complicated way of say- 
ing it is very old. 

The computer's hard disk had 
been upgraded from 20Mb to 
120Mb, and so was non-standard, 
and being non-standard had its 
parameters stored in CMOS. When 
the computer battery ran out, all 
this data was lost. To make mat- 
ters worse an obsolete computer 
uses an obsolete battery, and it 
takes a few days to find a shop 
selling obsolete batteries. 

We become surprisingly depen- 
dent on our hard disks. Three 
years ago | worked happily on my 
computer with a pile of floppies 
beside me. Now | just have two or 
three containing word processing 
documents or other files on which 
| am currently working. All pro- 
grams are loaded from the hard 
disk. Suddenly those programs 
were inaccessible. | knew they 
were there safely on the disk, but | 
could not load them. | felt like the 
alcoholic in front of the locked 
grille of a closed off-licence, or the 
heavy smoker whose lighter has 
just run out. 

Having worked professionally 
with people who display proble- 
matic substance abuse behaviour 
- ‘addicts’ to the politically incor- 
rect - | know a few tricks. It is 
amazing what you can hide in 
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| Feeling « out on a limb? 

i Reach out for O Branch 

4 Suppliers of Quality QDOS/SMSOQ products 
: Hardware and Software 


Hot news this issue is that we are reaching the end of the Super 
gold Cards and QXLs. There are only a few of these items left and 
they are disappearing fast. We will be offering trade in prices for 
The GoldFire when it is released later this year and having a 
backup device is essential if you use your system a lot. So don't 
delay - order now before or branches are bare ! 

Don't forget that a QXL in a 386 or 486 PC will perform faster than 
a Super Gold Gold or QPC in anything slower than a 200 MHz 
Pentium PC. There are a lot of cheap PCs around these days so 

there has never been a better time to snap up a QXL. Look at the 
special is + SMSQE price below ! 


0 Branch Programs 
The Knight Safe - Safeguard your hard disk data ! 
The Knight Safe 1 - standard version £ 30.00 
The Knight Safe 2 - with compression £35.00 


Q - Count £25.00 


Pointer Driven Home accounting 


Q - Route v1.06 £ 25.00 


Route finding programme 


H ardwa re Page Designer 3 S £40.00 


Pointer driven desktop publishing for big screens 
QXL II £ 180.00 7 


Super Gold Card £ 160.00 NEW PRICES !!! 
Recycled Gold Card £60.00 * 


Aurora E 100.00 The MC - Plate 


Qubide BO = SI een 


Monitor & Keyboard sockets 


Qplane £25.00 e @ wot \ 


Aurora cables £ 3.00 
Aurora rom adaptor £ 3.00 


The ‘Braquet' £16.00 
* when available. 


Package deals 
| QXL IE -+ SMSQ/E £220.00 | 
| Aurora + SMSQ/E £ 160.00 
Aurora + SMSQ/E + Super Gold Card £330.00 


All the socket holes you will ever need on the back of 
your tower case. Just rip off the silly PC thing and screw 
on this one. No cutting needed. What could be easier ? 


a Above je peeeee + Monitor 


P. O. Bax 7, Perislade. Sussex. BN41 2ND. UK. 


Tel +44 (0) 1273-386030 fax +44 (0) 1273-381577 
email qbranch@qbranch.demon.co.uk web : hitp:/A8~w.qbranch.demon.co.uk 


We can accept payment by VISA, Masiateard and Switch. You can also pay by| 


Eurocheques made out in Sterling or a Sterling cheque drawn on a UK Bank.) § 
Prices include Post and Packing in Europe. 
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The MinisQL is 
Coming ! 
Watch these 
or visit a local 
QL Workshop ! 


6, Branch 
Feeling « out on a limb ? 
Reach out for Q Branch 


| Suppliers of Quality QDOS/SMSQ products \ 
' = Hardware and Software 


ProWesS 


ProWesS £ 48.00 
DATAdesign £ 24.00 
Fontutils £ 30.00 
File Search £ 12.00 
PFlist £ 12.00 
Fontpack £ 60.00 


LINEdesign v 2.16 £ 24.00 
PWfile £18.00 


Just Words' by Geoff Wicks 


THESAURUS, STYLE CHECK, SOLVITPLUS 3 
£ 15.00 ea / ANY 2 PROGRAMS £ 25.00 / ALL 3 PROGRAMS £ 35.00 


I! NEW VERSIONS !W! 
THESAURUS V4.01 / SOLVIT PLUS 3 v 3.00 


Pointer drivens versions of Geoff Wicks popular programs. 
(needs Hot_rext, WMAN and PTR_GEN or SMSQ£ to run) 


Still the same price £ | 5 0 0 


Upgrades from previous versions £2.50 + S.A.E. 


Gold Card / Atari / QXL Version 
£76.00 


Various Atari versions : call for details 
QPC v1.43 
£90.00 — (£70.00 SMSQE owners} 


We can now supply colour laptops with QPC already 
installed { The systems are secondhand and vary 
considerably so you will need to call for details but a 
typical starting price for a 486 DX 70 Toshiba with 
350 Meg hard disk and 12 Ram complete with QPC 
and Carrying case is 


£ 500.00 (+ postage ) 
NEW PRICES ]!! 


PROGRAMMING 


QD v9.15 £ 53.00 
QD + QBasic £69.00 
QD + Qliberator + QBasic £ 110.00 
Qliberator £50.00 
Master Spy v 3.3 £30.00 
QPTR £ 37.00 
Easyptr pt 1 & 2 (together) £ 33.00 
Easyptr pt 3 (C library) £16.00 
QMake £ 18.00 
QMon/JMon £ 22.00 
Basic Linker £ 22.00 
DISA 3 £ 37.00 
£ 16.00 


~~ Youve been asking for it and here itis! Due out late June. Sy Over 500 ) 


| The SBASIC / Sup erBASIC Reference Manual | pages! 


| The complete definitive guide to rer programming in QDOS / SMSQ including | Car 
three disks of PD toolkits, example procedures and an electronic index. | pricing details| 
_ compiled by Rich Mellor, Franz Hermann and Peter Jaeger 


UTILITIES — 


FIFi2 £ 22.00 
QSup £ 32.00 


QSpread E 66.00 
Fountext 94 £ 39.00 | Cueshell 2 £30.00 


|i ert een Qload/Qref £15.00 
seas ears Disk Mate5 £16.50 
Text 87 is the only QDOS / QPAC 1 £20.00 
SMSQ wordprocessor 
capable of handliing the full 
screen on the Aurora /QXL/} 
QPC systems. New drivers 
are currently being written. 
| WATCH THIS SPACE ! 
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lavatory cisterns, just in case. 
What you can get away with by 
opening a window, lighting a can- 
dle and placing a wet towel by the 
door What you can do with a 
piece of silver paper and a light 
socket (Don't try that at home. 
kids). Neither of these was appro- 
priate in my case, but | was soon 
trying every trick in the book to 
get that hard disk back in opera- 
tion, but all fo no avail. | had no 
choice. | had to face life without 
my hard disk. This was cold turkey 
for real, man. 

“Aha’, | hear Mark Knight say, 
"Did you back up your hard disk? | 
have this nice little program...” Yes 
Mr Knight, | do back up my hard 
disk. | back up everything. In fact 
you need two back ups. One of 
the hard disk information as it Is, 
and the other in a form that can be 
used directly from the disks. Never 
forget we customise our programs 
to run from hard disk. 

Once | started to think about the 
problem rationally, | was soon de- 
vising a survival strategy. | asses- 
sed my computer needs for the 
next few days and realised | could 
keep these simple. | could load 
SMSQ from floppy, and had pointer 
environment files on disk that 
could be quickly adapted for use 
on the QXL. | made up a disk to 
load the essential DOS files, then 
SMSQ, the pointer files and 
QPAC2. | could continue word pro- 
cessing and program develop- 
ment. Even the use of Line Design 
would still have been possible, 
although | decided against it. | had 
a system that was Cumbersome to 
use, but which worked. 

In fact | had a QL in a PC that 
was unusable as a PC but usable 
as a QL. Most QL programs can 
still be run from floppies, but al 
most all PC programs have to be 
run from hard disk. PC wordpro- 
cessing would have been impos- 
sible unless | had reverted to using 
WordPerfect 4.2. We are fortunate 
as QL users that when we have a 
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hardware problem, we can usually 
improvise a way round if. Our PC 
colleagues are not so lucky. 

Even when | had fitted a new 
battery my troubles were not over 
| needed to know the parameters 
of the hard disk. Fortunately | had 
made a note of them. Then it 
proved impossible to enter these. 
After many attempts and some 
experimentation, | discovered that 
both the computer's manual and 
help screens gave incorrect instal- 
lation information. Again an advan- 


Gee Graphics! (On 


Herb Schaaf 


Ellioses, Ellipsis, 
Eccentricity, 
Extendicity? 

Thanks again for all the kind 
words and encouragement about 
this series from the people at the 
Bedford USA ‘98 QL show. Be- 
cause of this series I'm learning a 
lot of things | never knew, and 
learning again that there's a lot 
more I'd like to learn about! 

ELLIPSE is just another way to 
spell CIRCLE as far as the QL 
knows, and you may use the two 
terms indiscriminately for all it 
cares. If given only three parame- 
ters it wants to do a circle; if given 
five parameters it tries for an 
ellipse. Then too there are the cor- 
responding ELLIPSE_R = and 
CIRCLE_R that Remember where 
the graphic cursor was so that 
Relative shifts of the first two 
parameters can be made. 

The QL ProCedure ELLIPSE 
uses 5 numerical parameters: 

- Graphic Horizontal Center 


- Graphic Vertical Center 


- Graphic Vertical Radius 
- Ratio of Horizontal Radius to 
Vertical Radius 


- Inclination to Horizontal axis in 


Radians 


tage of being a QL user When you 
have a QL problem, there is usual 
ly help at hand, either through a 
Quania subgroup or even the 
trader. Where do you go for help 
as a PC user? 

My hard disk problems are 
solved. That big finger in the sky is 
no longer pointing in my direction. 
So look after your hard disk and 
back it up regularly. The big finger 
is pointing at someone else. It 
could be youl 
| 


the QL?)- part 5 


The 4th parameter, is called ec- 
centricity in some QL guides, but 
is really the ‘aspect ratio’ (width/ 
height} of the ellipse. 

“Eccentricity” is an example of a 
word that has different meanings 
depending upon context. When 
some QL guides refer to the ec- 
centricity of an ellipse, it is diffe- 
rent from the usual mathematical 
meaning of eccentricity as applied 
to the conic sections. The mathe- 
matical usage involves the ratio of 
the distance from a point on the 
curve to a foci as compared to 
the distance from the same point 
on the curve to a line known as 
the directrix. This ratio uses values 
from 0 (0 is a circle) to a little be- 
low 1 (1 is a parabola) for ellipses, 
and values greater than 1 produce 
hyperbola. We can think of the 
QL’s 4th parameter as a measure 
of how much a circle having a 
fixed vertical size is stretched or 
extended in the horizontal dimen- 
sion; perhaps a better term would 
be ‘extendicity’.. The QL permits 
this parameter to be negative or 
positive; if the ABSolute value of 
this ratio is 1 you get a circle, if the 
ABSolute value is less than 1 the 
circle is compressed in the hort 
zontal dimension, and if the 
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ABSolute value is greater than 1 
the circle is extended in the hort 
zontal dimension. 

There are limits when the QL 
refuses to draw the ellipse, as the 
shape approaches a line. Very 
small ratios and very large ratios 
just don't get done. The effect can 
be viewed in the program 
Ellipse_gone_bas’ where you see 
the QL trying, and then eventually 
giving up as the values become 
extreme. 

The 5th parameter turns the el- 
lipse about its center before draw- 
ing it, for example PI/4 will rotate it 
45 degrees counter-clockwise, 
and -PI/4 will turn it 45 degrees 
clockwise 

Now have a look at listing 1 
please. 

Ellipsis in the form of’... is used 
in writing to show that something 
has been left out of a quotation. | 
wish | knew the word for showing 
that something has been changed 
within a quotation (alteration, or 
perhaps the opposite of emenda- 
tion?). | see that the program 
Show _ARCircle_bas in QLloday 
May/June 1998 had a few changes 
along the way from me to the 
printed page. The changes involve 
non-ascii (8 keys at once!) QL 
characters that I've found conve- 
nient, but seem to have been 
translated before the final printing, 
perhaps by some printer trans- 
lates. [More likely by PC-QL email 
translations - Editor] 

| find that the symbol for degree 
is available on the QL as (CTRL 
SHIFT Z) = CHR$(186). It came 
out as an acute accent in lines 
430, 1110, and 1390. The QL 
provides an Up Arrow with (CRTL 
SHIFT 6) = CHR$(190), on line 
1390 it came out as an R in an 
oval. (How does an oval differ from 
an ellipse? - more about this 
further down.) The QL has a Down 
Arrow with (CTRL SHIFT -) = 
CHR$(191) which came out as a 
blank on line 1390. 
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100 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
230 
240 
250 
260 
270 
280 


Listing 1 


ESS ES ESSENSE SSS RESETS 


REMark Ellipse_gone_bas 
REMark HL Schaaf June 3, 1998 


WMON : PAPER 0 : INK 6 : MODE 4 

SCALE 100,0,0 : CLS 

CSIZE#0,3,1 : CLS#0 
PAPER#2,4 :INK#2,0 :CSIZE#2,1,0 :CLS#2 
PRINT#2\\,"E 1 lipses" 
PRINT#2\\" A series of ever decreasing" 
PRINT#2;" ratios is used, the vertical" 
PRINT#2;" dimension staying the same." 
PRINT#2\\" the ellipse is shown normal," 
PRINT#2;" then turned 1/8, then 1/4" 
PRINT#2;" of a circle" 

prompt 

FOR i = 1 TO 24 

extendicity = 1/(i°2) 

CLS 

ELLIPSE 40, 50, 40, extendicity, 0 
PRINT ' ratio = ';extendicity, 

prompt 

ELLIPSE 40, 50, 40, extendicity, PI/A : PRINT'1/8', 
prompt 

ELLIPSE 40, 50, 40, extendicity, PI/2 : PRINT'1/4' 
prompt 

END FOR i 


PAPER#2,4 :INK#2, 0 :CSIZE#2, 1, 0 :CLS#2 
PRINT#2\\,"E 1 1 ipses" 
PRINT#2\\" A series of ever increasing" 
PRINT#2;" ratios is used, the vertical" 
PRINT#2;" dimension staying the same." 
PRINT#2\" Scaling is adjusted to fit." 
PRINT#2\\"" the ellipse is shown normal," 
PRINT#2;" then turned 1/8, then 1/4" 
PRINT#2;" of a circle" 
prompt 

FOR i = 0 TO 12 

extendicity = 27i 

SCALE 100 * 27i, 0, 0 

CLS 

ELLIPSE 40*2°i, 50*27i, 40, extendicity, 0 
PRINT ' ratio = ';extendicity, 

prompt 

ELLIPSE 40%2°i, 50*27i, 40, extendicity, PI/4 
:PRINT'1/8', 

prompt 

ELLIPSE 40*27i, 50*27i, 40, extendicity, PI/2 
:PRINT'1/4' 

prompt 
END FOR i 
WMON 
STOP 


DEFine PROCedure prompt 

CLS#0 

PRINT#0;" Any key to continue" 
PAUSE 

END DEFine prompt 
REMark end of listing 


A friend who knew | was trying 


Listing 1 to get a better understanding of 
100 REMark Extendicity_bas ‘ellipse’ suggested | check out a 
110 REMark HL Schaaf June 4, 1998 recent (1996) book from the 
120 REMark takes eccentricity as input library: “Feynman's Lost Lecture’ 


130 REMark and converts to ratio for QL : . 

140 REMark displays ellipse and foci by David L. and Judith R. Good: 

150 REMark and circles for major and minor axes stein, ISBN 0-393-03918-8. | found 

ne eer a eer eae it of interest, and you may also, 
ark lines ‘0 allow this to be run os 

175 REMark as an executable job in SMSQ/E The amount of eccentricity that 


180 


IF VER$<>"HBA" : GO TO 230 


RA 


Kepler puzzled over in trying to 


190 JOBLNAME "Extendicity" find the orbit of Mars is indeed 
200 OPEN#O, con small, so it is all the more marve- 
210 OPEN#1, con 
220 OPEN#2, con | — lous that he was able to work it 
| 230 WMON out. I've included a small program 
oe ee , ‘Extendicity_bas’ which displays 
| 360 INK 4 ‘ the eccentricity of a few “heavenly 
270 SCALE 100,0,0 | bodies’; the shape of the earth, 
280 CSIZE #0, 1,0 :CLS #0 | the orbits of selected planets and 
| ee ce Sat | Halley’s comet. It converts the ma- 
310 explain _  thematical “eccentricity” into the 
320 REPeat query QL's “extendicity’ ratio, and draws 
| is Ea: eadetcuneeyet Sueae the ellipse, the foci, and the circles 


for the minor and major axes. 


350 IF ecc <0 OR ece >=1 :PRINT #0;"0 to almost 1 ?":GO TO 

340 Please look at listing 2 now. 

360 REMark major axis will be 70 units The planetary orbits | er 
370 a = 35 : REMark semi-major axis a eee " oe : 
380 c = a*ecc :REMark foci distance from center : MUCN IIKe CICIeS ont they: vals 
390 INK 4 _ look a lot like ellipses too. The dif- 


CLS 

PRINT "eccentricity ";ecec 
REMark red foci 

INK 2 


REMark do both with only 1 call to CIRCLE with 


REMark the semicolon in the line below 


: 
q 
ee 
dq 
oA 


ference between an oval and an 
ellipse is that the oval is made of 
lengths of circular arcs joined to- 
gether while the ellipse is its own 
shape. Ovals can be made that 


450 CIRCLE 40-c, 50, 1 ; 40+c , 50, 1 
460 b = SQRT(a¥a-c¥c): REMark semi-minor axis approximate the ellipse, and per- 
470 REMark major, minor circles haps we will do some simpler 
480 INK 4 ones in a future article. 


CIRCLE 40, 50, a ; 40, 50, b 
PRINT "ratio ";a/b 


Sst caosses sacs tata aGs 


Next time | hope to explore the 
question: "how far is it around the 


510 REMark white ellipse 
ete ale Tae ee ee ellipse, or what is the perimeter of 
2PUGV4 4 i . 
540 END REPeat query an ellipse’. 
B50): me 
560 DEFine PROCedure explain : 
570 PAPER#2,4: INK#2,0:CLS#2 a 
580 PRINT #2\" Here are some values for" : 
590 PRINT#2;" the eccentricity of a few" : RefileWitbel: 
600 PRINT#2;" heavenly bodies." 
610 PRINT #2\\" shape of Earth -0818" o 
620 PRINT #2;" orbit of Earth 0167" We Need 
630 PRINT #2;" orbit of Mars .0934" 
640 PRINT #2;" orbit of Mercury .2056" : 
650 PRINT #2;" orbit of Venus  .0068" a 
660 PRINT #2;" orbit of Pluto .2502" q 
670 PRINT #2;" Halley's Comet .9675" E 
680 PRINT #2\\\" — enter values of choice" : 
690 PRINT #2\\" foci will be shown in red" fe 
700 PRINT #2;" circles of major and minor" a 
705 PRINT #2;" diameters will be in green" : 
710 PRINT #2;" and the ellipse in white." : 
720 END DEFine explain q 
Ee 


730 REMark end of listing 


o 


Se 
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What are all these 
addresses? - Part 2 


by Nasta (Zeljko Nastasic) 


Things have substantially improved with the SGC. 
Not only did it expand RAM, but an IO area was again 
reintroduced, and even the QL ROM can be still read, 
albeit at a different address. Notice that on the GC, the 
usual QL addresses, like the IO and the screen RAM 
areas, appear at the same places as usual. They also 
do in the SGC, except that the address of the IO area 
appears the same as on the QL on the expansion bus, 
although to the CPU it is very different. The same 
applies to the QL ROM, too: 


designed, the obvious solution was to use the IO area 
for this screen RAM, much as the TC used it for 
expansion RAM. Unfortunately, with the Qubide, the 
upcoming RomDisq and the anounced UGC, things 
have again become very much plugged up. The 
Aurora uses 240k of the IO area out of 256k available. 
Only the top 16k of IO area ts actually available for use 
by peripherals. The idea was to set Qubide to operate 
at this address (bus address FCO00h) to keep the 
ROM slot free again, in SGC + Aurora systems. In fact, 
The Aurora introduces yet another small |O area of 
15.5k, by additionally decoding the original QL internal 
lO, in a somewhat desperate attempt to free some 
address space. Table 8 shows what the Aurora 
address map looks like (compare it with the original 
QL). 


Table 6: SGC bus address map 


Table 7: SGC internal address map 


oco00 “OFFFFn [ROW sict SSC COT 
38000 SEFFFR 


QL RAM, screen 1 WO, Appears only if scrl enabled 
SonnOn FERPA [G6 area 25GR ee ee 


--O2Z7FFFh 
.-LFFFFFh 


0200 
0300 


Suite the SGC offers a 256k | lO area, ‘ WReS ike 
extended graphics were finally possible. But, users 
wanted a lot of colour and high resolution, which would 
mean a lot of screen memory. Already available RAM 
cannot be used for this, because it's on the SGC - it 
doesn't have the necessary circuits to display its 
contents onto the screen! When the Aurora was 


cgg000h...00BFFFh | QL ROM image in SGC RAM 
ocd . OOFFFFh ROM slot uses 8 bit bus sizeing 

O10 .-O17FFEh Toolkit II and SGC software image 
018000h...01BFFFh uses 8 bit bus sizeing 
Qico00h...01FFFFh_| SGG_RAM fe ee 


SGC RAM R/W, QL RAM write 
SGC RAM R/W, QL RAM write 


200000 .  SEFFFFA SGC RAM 

4000 . -40BFFFh QL ROM (actual, not image!} Remapped 
a0c000h..-4BFFFFA 

4c00 -4FFFFFH IO area, 256k Remapped 
50090 FEFFFEH 


Anything written copied to QL RAM 
QL RAM write only if scri enabled 


Although this has so-far been neglected, the Aurora 
has the capability to use a larger size EPROM, 
anything from 64k up to 512k. Access to it is provided 
by pageing any 32k block of the EPROM (up to 16 in 
the 512k EPROM) into the first 32k of the space used 
by the original QL ROM. This feature can be utilised on 
the SGC since the QL ROM space is accessible even 


00 
0 


0 
00 


-O7FFFH 
-OBFFFh 
. OFFFFh 


L7FFFH 
180FFh 
IBEFFh 
IBFFFh 
1LFFFFh 


800 BFFFFh Copy of 00000h 3SFFFFh 
coao . -FBFFFhA Extended screen RAM, 240k 
FcOOO FFFEFR 
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Table 8: Aurora address map 


O0000h.. 
U8000h.. 


QL ROM, lower 32k 
OL ROM, upper 16k 


Bank swiched, see below 


extended ROM slot, 16k Write signal added to ROM slt 
Unused, 32k Not accessable by GC/SGC 


QL IO (8301 chip) 256 bytes | Aurora control registers included 


Extra IO area, 15.5k Select signal added to ROM slot 


Integrated QIMI, 256 bytes Partial decode, 2 addresses used 


Unused, 16k Not accessable by GC/SGC 


Not accessable by GC/SGC 


Not used, 16k Remaining part of IO area 
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after its copy has been stored into protected SGC 
RAM and pached. Because of this, once the SGC has 
started up, the ROM may freely be page-switched 
because it is not used any more by the system. If any- 
one wants to use this, details are available. 

Another Aurora introduction is the Extra 10 area. As 
such, it is decoded on the Aurora, and a special signal 
is provided on Its extended ROM slot connector, which 
becomes a logic 0 when any address in this area is ac- 
cessed, Provided you are not using the ROM slot for 
something already, a simple piece of hardware could 
be interfaced to it without too much difficulty, or the 
need to manage the usual QL signals - a simple ad- 
dress decoder is enough. This area has been chosen 
because it is not used by anything else, and the GC 
and SGC can access it. Of course, the GoldFire will be 
able to do so as well. The idea behind the Extra lO 
area is to have peripherals use multiples of 256 bytes 
of it. 256 bytes is usually more than enough to map in 
the various registers used by a great variety of IO 
devices. Unlike normal QL peripherals, the idea is not 
to have the accompanying ROM, which usually takes 
up 16k. So, in order to use those peripherals, the drt 
vers have to be loaded from disc, or a similar device. 
Several 256 byte areas are already reserved: 


The Aurora also has the decoder disabling input, 
DSMC, implemented, just like the original QL. Like on the 
original QL, it is possible to disable any or all of the 
Aurora address decoding by pulling this signal high when 
an address of interest appears on the address lines. This 
address can then be used by external devices. 


GoldFire 


Just a quick preview of changes which will be 
brought on by GoldFire. The GF has a pretty complex 
address map, since it introduces many new features. 
The existing bus features are expanded to include a 16 
Mbyte address range (24 address bits), and selectable 
access speed. A 32-bit access mode is added, as well 
as a dual CPU feature which needs to be catered for 
See table 10 for the GoldFire address map. 

The GF expands on the existing 8-bit QL bus in 
three ways, of which two are relevant for this article. 

Firstly, the GF provides for 24 address lines, 
extending the range of adresses on the bus to 16 
Mbytes. The additional 4 address lines appear instead 
of signals which have ceased to have an useful mean- 
ing with the evolution of QL hardware. The bus lines 
are FCO, FC1, FC2 and E. 

Secondly, it is possible to generate bus addresses in 


Table 9: Extra lO area 


18100h...187FFh Reserved 


The extnded ROM slot fiproides 5 5 additional cision 
compared to the standard QL ROM slot. Those are 
-RESET -EXTINT -WR, -DS and -EXIO (Aurora users will 
find the locations of these and other signals in the 
Aurora manual). The first four correspond to the simr 
lairly named signals on the QL’s expansion bus. The 
signal -EX!O is generated by the Aurora, and becomes 
a logic Q whenever an address in the range 
18100.1BEFFh is detected, to aid simple IO devices to 
be interfaced with minimum additional circuitry. 


18000h...180FFh Original QL IO and Aurora registers : 


1¢400h...18EFPh : 
zas00n=..18eFEN | on-bosed gree 


Future peripherals : 


two ways. The first way is accessing them as the Ts 
QL addresses, meaning the ones which have to ap- 
pear at certain places because of compatibility. These 
are the ROM, the on-board IO and the screen 0 and 1. 
The second way is accessing the multiple 8-bit IO 
areas which all map to bus adresses 000000..FFFFFFh, 
but with subtle differences depending on which 10 
area iS accessed. 

The 32-bit bus protocol is designed so that old 8-bit 
peripherals and future 32-bit peripherals can co-exist 
on the same bus. 


Table 10: GoldFire internal address map 
00000000h..0000BFFFh QL ROM image in RAM write protected 
o000cU00h..0000FFFFh Appears on the 8-bit bus 
DOO10000h. .O0017FFFh RAM write protected 
OO018000h..0001BFFFh QL motherboard Io Appears on the 8-bit bus 
0O01c000h..0001LFFFFh RAM write protected 

Shadowed screen 0 area 
00028000h. .0002FFFFh Shadowed Sreeen 1 area 
90300000h..07FFFFFFh 
O8000000h..08FFFFFFh on- Se poard 512k Flash ROM Partial decoding 

Appears as 000000h..FFFFFFH on bus 
OcOO0000h..0CFFFFFFh On-board Io Partial decoding 
ODCO0000h..OFFFFEFFh shadowed 8-bit access Write only 000000h..FFFFFFh on bus 
10000000h..17FFFFFFh | copy of RAM area 
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Summary 
Presented here are two tables. Table 11 is the address map of the two possible QL type motherboards that are 


now in circulation - The original Sinclair one, and the Aurora: 


Table 11 * - Due to partial decoding on the QL motherboard, the E 
ppg mono n Gavices present in the OO0000.3FFFFh are repeatedly 

; mapped and appear at 40000.7FFFFh, 80000..BFFFFh and 

: CO000.FFFFFh. 

# - Depending on the programming of Aurora control 
registers the extended ROM socket on the Aurora can 

: page any 32k of the EPROM in it fo this area. Initially the first 

i nae paged here to allow correct emulation of the QL 
1 20000h | 27F re 4H - This area is further decoded on the Aurora. The usual 

, 28000h : QL motherboard addresses are provided together with an 

: 30000h : extension catering for the on-board QIMI interface The rest 

1 : iS decoded and a pin is provided on the extended ROM slot 

: for easy interfacing to simple IO hardware, see table and 

: explanations below. 


Start End 


FCOOCh ” Partial decode * Unmapped 


The following table summarises the address maps of the various expansion boards. To create a complete bus 
address map of your QL set-up, concatenate the column with the motherboard you use from the table above, with 
the column of the expansion you use from the table below, by replacing the ‘Undecoded’ or ‘Read only’ or 
‘Read/Write’ entries by the ones from the motherboard map: 


Table 12 


ae eager ae a aaded OF sia Bae ent eg 
48k | Undecoded 


FE ndecoded “””””"””"Gindecoded 
__TC ROM and IO 


Undecoded 
Undecoded Undecoded 


"38000h 


Undecoded 


__30000h tindecoded 


$ - Normally, the floppy disc interface maps itself to COO00.C3FFFh. On an expanded QL the rest of the 10 area, C4000.FFFFFh i 


+ - The TC has its on-board ROM mapped in a non-standard place which the OS will not automatically initialise. Because of this it is als 
initially mapped at 00000...07FFF where the CPU will start execution on reset. The code forces the OS to recognise the TC ROM at it 
normal place and removes the initial mapping of the TC ROM. 

++ - The GC and SGC initialise from their on-board ROMs on reset, copying the QL ROMs to on-board RAM for faster execution. Therefor 
the usual ROM area at 00000..0BFFFh is only read, and once execution is resumed from the copy, that address block becomes inaccessibl 
on the GC. It can be still accessed if a SGC is in use. On a SGC the bus addresses 00000.0FFFFh can still be accessed as memor 
addresses 400000..40FFFE 

ek - The GC and SGC never generate these addresses on the bus. 

*##* - The shadowing used by the GC and SGC generates writes to these addresses expecting a write to screen memory to be the result 
A write to the same address in the GC/SGC on-board RAM is also performed. Reading is allways done from GC/SGC RAM as it is severa 
times faster Read accesses are never generated on the bus at these addresses. Also, writes to the Screen 1 area (28000..2FFFFh) are no 
generated on the SGC if the second screen is disabled by the SCR2DIS command. 


Next time: How to use the expansion bus, Rom slot and Aurora enhancements in practice, with examples. 
@ 


¢ extensive re-writing, it deserves a renewed look. 

DBEasy v1 6 rei A Review For those not familiar with DBeasy, it is a front end 
by Al Feng program lor the Archive [Psion] database program 
Some programs are so well designed that it which is available either for QDOS/SMSQ (v1.6) or for 
sometimes takes years for the user to appreciate the DOS {v1.3}. While there were minor feature differences 


many features which the program author has thought: Petween the two versions in the past, they now 


: ; appear to be almost identical in function and operation. 
aes Re Hea concn Mee ie Those not familiar with DBEasy may think that it is 


certainly a well designed program that has rightfully  S!Mply a menu program for loading and viewing data 


been well received. With the program undergoing an bases. It is more. It is a program for creation and 
management of any database you may wish to 
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create, use, and maintain (for example, altering/upda- 
ting fields and maintaining by adding/deleting records). 


General Database Design 
Philosophy 


From what | have gleaned over the years, there are 
two types of databases - hierarchical and relational. 
While the hierarchical database came first, most 
modern databases are now relational. Archive is a 
relational database with an integrated, procedure 
based programming language. 

Hierarchical databases usually seem “better” to the 
novice because they are designed with a non-discri- 
minating, ‘flat’ field structure. Essentially each field (or 
screen} is a record, and conversely each record Is a 
field, thus allowing any piece of data to be put 
anywhere in a given record. In essence, a hierarchical 
database record can be thought of as one ina set of 
electronic file cards. Thus, to use a_ hierarchical 
database, you just name (create) the database file, 
open it, and then start inputting whatever you desire 
into any record. 

In theory, you could simulate a hierarchical database 
by creating a single field database within a relational 
database. In Archive, you would: 

CREATE "flat" <ENTER> 

flat$ <«ENTER> 

<« ENTER> 

After this, you would use the SEDIT (ie, screen edit} 
function to create the screen with a single field 
essentially taking up as much of the usable screen as 
you wanted; and then, SSAVE (ie. screen save) that 
screen. You would still OPEN, SLOAD ({ie., screen load), 
ALTER, and CLOSE the database as you would a 
normal Archive database. If you were inspired, you 
could EDIT a program to expedite navigating your 
‘flat’ field database. 

Because a hierarchical database does not have 
fields, per se, It is not possible for the user to easily, 
or consistently manipulate the data of individual 
records. For example, it would not be easy to use a 
‘flat’ field database for printing names and addresses 
on labels unless the entire contents of each record 
was comprised of consistently placed names and 
adresses. 

My understanding is that a simple FIND query is not 
handicapped by searching a hierarchical database. 

The HYPERCARD database (APPLE Macintosh} 
appears to be a hierarchical database which has user 
linkable elements. The selectively ‘programmable’ 
links and inherent graphical nature of the database 
provide an extended versatility not available with a 
simple, hierarchical database. 

Relational databases differ in that the individual 
fields (text or numeric) must be pre-defined BEFORE 
data can be input. The need to pre-define the fields 
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can be particularly discouraging for the novice; and, 
the same novice may wonder why or how relational 
databases have become so prevalent. 

In a relational database, the OUTPUT of various, 
individual fields can be ‘manipulated’ so that it suits 
multiple needs; thus, one set of data can be used and 
output in more than one way with differing fields 
included-or-excluded in a particular output. The 
unqualified advantage of a relational database 
becomes most apparent when you have the 
opportunity to use a front-end program such as 
DBEasy. As designed, DBEasy allows you to print: 

1) the individual record: 

2) an address label (if applicable): 

3) a line of user-specified fields: and/or, 

4) a “custom” output (a future article). 

The output can be to your printer the screen, or a 
file (for import to QUILL, for example) when the 
request Is initiated from the MULTIPLE MENU screen 
and to the printer only from the SINGLE MENU screen. 


The Design 
DBEasy uses a MAIN MENU which allows the user 
to branch to ten other functions: 


Single menu __w/ find, search, insert, alter, delete 
Multiple menu w/ select, order, print, copy, export 
Log menu w/ add, change, remove, import, capture 
Backup backup the current database 

sWitch switch the active database 

Help access the DBEasy help system 
Directory w/ copy, delete options 

Configuration set video or date style 

Rescreen check database / redraw screen 


Quit DBEASY all done 

In earlier versions you would navigate this screen by 
pressing a number key (1 to 9) to put the pointer 
arrow on a given line, or by using the up-or-down 
cursor key to move the pointer up or down from line 
to line. ‘0’ would provide a fast branching to the exit 
screen. 

With the most current version, the HOT KEYs 
developed in QLERK are now available for use in 
DBEasy - generally, pressing the first letter of the KEY 
word will move the pointer arrow to the line or option; 
or activate the options within the secondary menus. 
Each version change over the years has made 
DBEasy more convenient to use; and, | would guess 
that it only took about five minutes to become 
comfortable with the new HOT KEY feature. 

A welcome change is the increased facility to quick 
“sWitch’ the active database from one to another A 
“sWitch’ can also be executed from the SINGLE and 
MULTIPLE MENU as well as from the LOG MENU (the 
LOG MENU was previously named “Switch mode’). 
When using the ‘sWitch’ routine, you do not have to 
type in the entire database name, only enough 
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characters to distinguish one database from another 
Thus, when! want to access my ‘PLAT YPUS_dbf" | do 
need to type in at least “PLAT” since typing in ’P” or 
PL’ or *PLA’ will always locate the “"PLANNERX_ dbf’ 
first. If | were to remove the “"PLANNERX_dbf’ from the 
drive, then simply typing ‘P” would result in DBEasy 
querying me whether or not ‘PLAT YPUS_dbf’ was the 
one | wanted. 

In the past, if you wanted to change the date format 
at the top of the MAIN MENU screen, you needed to 
edit and re-save the DBEMM code. This is now an 
option which can be done from the main menu. There 
are now three formats for displaying the date on the 
MAIN MENU [YYYYMM/DD, MM/DD/YYYY & 
DD/MM/YYYY}. 

The HELP_dbf file is now available as a HOT KEY 
from almost any point in the program by simply 
pressing 'H’ «ENTER» 


The Design in Practice 

All the databases which are CREATEd have the 
same fields - twelve text fields (date_$, key_$, si_$, 
et cetera} and six numeric fields (ni_, n2_, et cetera). 
While | originally thought this would be limiting, | have 
found that this is a good compromise for most 
databases. 

In day-to-day use, one of the apparent benefits of 
using DBEasy is that it eliminates the need for 
pre-defining the fields of each database. If you don't 
like the labels, you can change them later. 

The “date_$’ field is automatically filled when you 
INSERT a new database; but, any other text data can 
be inserted therein. The ‘date_$° was automatically 
updated to the current date in prior versions, but this 
has been changed with the current version whereby 
the current version maintains the record's ‘original’ 
date - as | generally did NOT want this field changed in 
the past, | did find the automatic updating of the field 
disconcerting; so, [m glad that the newest version of 
the program keeps this unchanged. 

lf necessary, the actual DBEasy program (ie. 
DBEMM_pro) can be modified to accomodate more or 
less fields; of as demonstrated with the newly incor- 
porated, ADDRESSX_dbi, the specific screen can be 
customized (using SEDIT & SSAVE) to accomodate 
different field_lengths. 

Of course, the labels assigned to the fields can be 
changed at any time; and, a new option lets the user 
create new databases by ‘capturing’ data from exist- 
ing DBEasy database files. 

When you choose the MULTIPLE MENU you can 
view up to ten LINEs of truncated RECORD data per 
screen page. In the past, the LINE represented three 
user selectable FIELDs of data. This has been greatly 
improved with the current version being capable of 
displaying at least seven fields of variable length. Each 
LINE format can be exclusive to a particular database. 


QL foday 


The "Capture" Pitfall? 


There is a very small inconvenience that you have 
to suffer if you are upgrading from a previous version 
- the DBELOG_dbf contains different data than in pre- 
vious versions. Presumably, it is the difference in struc- 
ture which now allows the user to ‘capture’ data from 
already logged databases when creating new data- 
base files. 

It seemed that the only files that did transfer were 
my VARIOUS dbf files and the DBEASY_scn that | use! 

However, after you get over the shock of not being 
able to simply the transfer various ancillary files along 
with your VARIOUS_dbf files you will quickly appre- 
ciate the “capture” function; and, the setback is minor 
compared with the gain. 


Customization and Cosmetic 


Modifications 

You may not have to make any changes to the pro- 
gram to use DBEasy: but, if you do, most customiza- 
tion is now easier or faster to implement. Cf course, 
the single RECORD screen can simply be copied from 
your previous DBEasy program disk (if it is different 
from what is provided) - for example, the colors of my 
single RECORD screen complement the MAIN MENU 
colors | had chosen to suit my personal sensibilities. 

Okay, as good as DBEasy is, it probably isn’t ‘per- 
fect’ for you as it comes out-of-the-box any more 
than it was for me. 

Based on the earlier DBEasy versions, | knew that | 
would have to ‘go inside’ and modify the print option 
to add a few ‘Iprint’ statements to adjust the printer's 
vertical spacing for the labels which | currently use (4° 
x 1 7/16’). Of course, the first thing | had to do was to 
(escjape to Archive's command_line and enter the 
edit mode and then edit the proc(s) [consult the QL 
USER GUIDE if you don't know how to do this}. 


proce easy_out_lbi 


if ns: print at ml,12;rs;: endif : let 
ig=si_$: if s2_$<onul$: let i$=s2_$+sp$+i$: 
endif 


iprint : lprint i$: Iprint s3_$: if 
s4_$<>nul$: Iprint s4_$: ndif : lprint s5_$;", 
"5s6_$;" ";s'7_$: lprint : lprint : lprint : 
lprint tab 15;"": if s4_$=nul$: lprint : 
endif : let line=6 


endproc 


In addition to adding ‘Iprint’ statements, | also omitted 
the statement which printed field "s9_$° which is used 
for “country” since | generally use *s9_$° for other 
comments. 

All of the remaining changes described here are 
cosmetic to suit my own sensibilities and do not 
enhance or improve the operation of the program. 
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The least significant change | made was to the 
QUIT page. This was the easiest to implement since it 
essentially involved adding a long enough string of 
periods ("......} to tidy up the appearance. 


proe quiter 


heady;"Quit DBEasy":yorn;0, " Quit DBEasy 


PPOZTAaM ...eee ": if ans$="n":start: stop : 
endif :yorn;0, " Quit ARCHIVE, also ....... yan 
if ans$="n": new : else : quit : endif 


endproc 


After that, there were some other cosmetic chan- 


ges that | made to the MAIN MENU and LOG MENU 


because | liked the ‘look’ of the previous versions (at 
least, the way | had them) better than the current 
appearence. 

The changes to the MAIN MENU were primarily 
done to the header related procs. 


proc arrow_mess;1,m$ 

let i=(80-(36+len(m$)))/2 

paper sink 

ink spap 

print at 1,1;rv$; tab i; "Use arrow keys or 
Hot Key to choose "+m$; tab 79; print at 


1+1,1; tab 25; "<ENTER> to select or 0 to 
exit"; tab 79;rv$; 


paper spap 
ink sink 
endproe 


Changing the ‘arrow_mess’ tidies up the MAIN 
MENU box by coloring the related lines to the same 
color as the outer field. Modifying the “heading” was 
mostly rearranging the text and the heady’ made the 
banner the full width of the screen, as on earlier 
versions. 


proc heading 


heady;nul$: paper hpap: ink hink:runtime: let 
j=ans: timey 

print at 1,2;upper(sys$);" MAIN MENU"; ink 
sink; at 0,36;today$; tab 54;"Day ";day;" of 
"; val(date(0)); ink hink; at 1,37;ans$; tab 
54;j;" minutes since start" 


paper spap: ink sink: if begent=--1: let 
ig="-"; else : let i$=str(begent,2,zer): endif 


print at 4,2; ink spap;desc$; 


print at 4,52;"Module : DBEmm"; at 5,52; 
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"DEVice =: "s;pd$; at 6,52;"Database : "; sf$ 


print at 7,52;"Records : ";i§$ 


endproc 
proc heady;i§$ 


paper spap: cls : paper hpap: ink hink: print 
at 0,0; tab 80; at 1,0; tab 80; at 2,0; tab 
80; at 1,2;1$;: paper spap: ink sink: print at 
4,05 


endproc 


Still in a “retro” mode, changes to the LOG MENU 
were next. The changes to the LOG MENU were done 
to, you guessed it, log related procs; and again, the 
changes were made to resemble the appearance of 
earlier versions. 

The simple part was to remove the statement which 
indicated the ‘active database’ in the ‘log_menu’ 
procedure by truncating the fifth line. 


proc log_menu 


print at 17,3;"of ";npg; tab 79; at 18,1i;rv$; 
tab 79; 


eee 


endproc 


The real trick was to highlight the active line to echo 
the previous versions, Of course, the hardest part was 
to actually find which procedure performed this func- 
tion! Not surprisingly, it is in the “log_show’ procedure. 
The asterik (*) has been replaced with the 
greater_than sign (*>'}, but can be eliminated since it is 
now superfluous for most video configurations. 


proc log_show; pg 


let k=10*(pg-1):position;"1",rl,k: let j=5: 
print at j,zer;:usel 
while not eof("1") and rlck+10:usel 


let i$=desc_$: if len(i$)>33: let i$=1$(1 to 
33): endif : let j$=user_$: if len(j$)>10: let 
j$=j$(1 to 10): endif : if act_: paper sink: 
ink spap: let k$=" >": else : paper spap: ink 
sink: let k$=nul$: endif 


print sp$;rl;k$; tab 4;sp$;sd_$; t ab 
5+d1;sp$;sf_$; tab 23;sp$;i$; tab 58;date_$; 
tab 68; 5$ 

tab 80: ink sink: paper spap: let 
j=j+1:plnext: endwhile 
box;j,zer,14,80,nul$: let j=16 

paper spap: ink sink 
print at j,6;pg;"_"; 


endproc 
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Alter you make each change, you will want to see if 
it either looks right, or ‘works’ the way you want it to. 
Of course, you will also want to save it to a working 
copy of the program by inputting: 


save object "DBEmm" «ENTER» 


| made the same changes for both the QDOS and 
the PC version of the program. In each case, you will 
want to compare and insert/change lines to match 
what you see listed. After you have made changes, 
you can further modify the procedures to fit your 
sensibilities instead of mine. 


GUI - Phooey! 

There are alternatives to Archive (more so for the 
DOS world). 

The essential thing to know is that DBEasy is NOT 
handicapped by being tied to a text-based program. 
Now, | realize that a LOT of people LIKE using a 
mouse - you know, trying to move the pointer to a 
viable spot on the screen as if it were a game; but, I'm 
not one of them. 

In day-to-day use, you only need the cursor keys 
and ENTER key, or a mouse, to navigate the program. 

Generally, the only time you need to use the 
alphanumeric keys is when creating/deleting a 
new/old database, or when making changes within an 
existing database. 

lf there are some situations when you need a 
secure environment, then a copy of DBEasy running 
on a QL without a keyboard (of course, with a pointer 
input device) would probably be more secure from 
tampering than a GUI database which would probably 
remain vuinerable to change or removal. 


The bottom Line 

lf you aren't using Archive, yet, then you should 
consider getting a copy of DBEasy since it will make 
using a Dfata)Bfase)Easy. 


For your Eyes Only! 


Jér6me Grimbert 


Subtitle "or Time for 16 colours, NOW!” - and the author gives 
you some very interesting aspects and suggestions on how to 
use more than eight colours with existing hardware, or more 
precisely, how to refer to them in our current system of “naming” 


colours 0 to 7. 


Because | come from a long line of read-the-instruc- 
tions-last people there are certainly features and func- 
tions which | have failed to discuss adequately (or at 
all) because | probably have not used them. yet. For 
those who like to read, there is an extensive 
DBEASY_doc which is obviously a good reference 
tool for using DBEasy, too. 

The QL disk contains an XCHANGE compatible ver- 
sion. Other than to say that the XCHANGE version is 
smaller than the ‘normal’ version, | cannot indicate 
what the difference is. The ‘normal QL and PC ver- 
sions are essentially the same. 


An additional ‘_dbf file is now _ included 
(PLANNERX_dbf) which can be used as a daily 
planner. 


Unlike PC users who currently do not have access 
to Archive, DBEasy is reason enough to use Archive, 
and would be reason enough for database users to 
use a QL or QXL as their hardware platform. 

Before | started to use DBEasy, | would use the 
back pages of my check book register for names and 
addresses! At the time, it just seemed to me that with 
less than 50 names/addresses/phone_numbers of 
various sorts that it was far easier transcribing those 
names (as needed) than to learn to use Archive. Were 
it not for DBEasy, | am certain that | would still not be 
using the Archive program, or any database program 
for that matter. 

lf you are using a previous version of DBEasy, | am 
sure that you will not regret upgrading to the newest 
version. The HOT KEYs, alone, make it worth the 
effort to transfer files and make whatever changes 
need to be made. 

New users need to know that DBEasy is both EASY 
to use and EASY to modify if need be; that, ‘sample’ 
databases are included that can be amended with 
your own data; and, that your QL requires memory 
expansion beyond 128K to run DBEasy. 

The DBEasy program costs $24.00 (US); upgrades 
cost $7.00 (US). 

Eg 


and also the eight colour mode, 
but without the flashing, because 
it would have required specific 
hardware chips. Thus, on every 
platform, except the original QL 
one, in mode 8, there is a waste of 
one bit for every pixel. As usually 
the hardware on these platform is 
not limited to a True/False logic for 
the RGB lines, this means we can 


As everybody knows, the QL 
has two basic screen display: 
either 512x256 in four colours, or 
256x256 in eight colours with 
some flashing capabilities. 
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Then came the Atari emulator 
only on mode 4 but with a bigger 
resolution. And now we have 
many other QL compatible system, 
usually providing the four colour 


easily have 16 colours instead of 8. 

In fact, the problem is (or was) 
not to have 8 new colours, but to 
choose which one. The original 


43 


Y) 
e) 
a 
< 
0) 
an“ 
( 
ry 


+ 


M2|IAQ 


colours of the QL were arranged. 
from 0 to 7, in order of increasing 
luminosity (or perceived luminosr 
ty). Hence, when adding new 
colours we should have tried to 
keep these properties. But, as the 
programming interface does not 
allow us to go any further than the 
original range, due fo the fact that 
stipple and complex combinations, 
to remain compatible, must be 
specified in only 8 bits, with 3 bits 
for the colours. 

That means that the 8 new 
colours won't be numbered! 

- Uh? How do you use them if 
they have no number??? 

Well, in the current systems, they 
won't be. Maybe later but you 
don't have to rewrite the whole 
system just fo see 8 new colours. 
As stated earlier the problem is 
not to have them (on the standard 
32K of screen memory, we alrea- 
dy have the needed bits), the pro- 
blem is to 
choose them. 

Actually, | 
have seen 
three — diffe- 
rent systems 
QL-compatr 
ble displaying 
more — than 
eight colours 
(true colours, 
not counting 
an old hack 
for QL based 

hardware 

which 
switched the 
screen displayed between the 
two memory areas to create the 
illusions of more colours..). For the 
curious, they were: 

- the demonstration of the 256 
colours with the prototype of 
Aurora, at some Show 

- uqlx, modified by myself 

- QPC, with a specific program 
also written by myself 

Ok. back to the choice of 
colours: the problem with 16 
colours is that you start with a 


black 


Ad 


base of 8 colours and should try 
to have some kind of logic to 
produce the 8 new ones. Alas the 
black and white colours usually 
mess things up. If you darken all 
colours then what is darker than 
black? If you lighten all the colours, 
what is brighter than white? If you 
try to represent somehow the 
colour in the space, you usually 
end up with a 3D model, either the 
RGB cube, or the Hue/Saturation/ 
Value double pyramid. Look at the 
location of the 8 basic colours of 
the QL on these models. 


qreen 


blue oyan 


magenta 


green 


red yellow 


As stated earlier 
white and black 
usually give trou 
ble when trying to 
keep a logic de 
scription of the va- 
riation for the new 
colours. And what 
we usually want 
are two different 
shades of grey. So 
this left us with six 
colours to specify. 
Let's see how the 
standard QPC {but 
it's easy to change 
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that with Thierry Godefroy’s 
extensions, thanks Thierry) 
behaves: it has two shades of 
grey (we already agree on that..) 
and then darken every other 
colours. Well, let's face it, | don't 
like it too much. If you take a look 
at the cube or the double 
pyramide, the new colours are 
concentrated on a tiny part of the 
model. | do not ask (yet) for 
photo-realism, but if we are gonna 
have 16 colours, | would rather 
have a wider spectrum. By just 
darkening the original one, we do 
not add any new tincture, we just 
replace a stipple by a full colour 
We augment the resolution, but 
not the number of perceived 
colours. 


The colour codes are (full 24 bit, 
VGA should divide by 4 for direct 
programming): 00007F 7F0000, 
7F007F 007F00, 007F7F 7F7F 00. 

Of course we could choose to 
lighten the six colours, but with 
this we would have the same 
trouble (just a symmetry in either 
model). But, if we look carefully in 
the cube model, there are many 
six just laying around. The cube 
has 8 vertices, 6 planes and 12 


dges. Why not try to put the six 
new colours in the middie of each 
plane? Well, | tried, with a PC and 
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|The RomDisq! Fully functional! See also 
previous issue of QL Today! Extremely small 
|board for the QL's ROM-Port, works like a 
| permanent RAM-disk, even if the power is taken 
| away contents are not lost! 
DM 129,00 
|RomDisq 4MB 

| RomDisg 8MB 


| Aurora Adaptor for RomDisq DM 9,90 


|Two games Upgrades: Diamonds and 
‘QShang. They are playable on all 
| systems (including Minerva and SMSQ/E) 
|and work in higher screen resolutions too. 
Other advantages are, for example, the 
| ability to configure the file in which Qshang 
| saves the highscores.. 

Diamonds costs new DM 36,- 

lor as an Upgrade DM 16,- 

| QShang’”* costs new DM 36,- 

jor as an Upgrade DM 16,- 
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Screenshot of 
QShang 
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The colour drivers are coming. In order to be able 
to upgrade to the colour drivers, you need to have 
SMSQ/E. The “normal” SMSQ which is shipped 
with the QXL card will not be able to handle more 
colours. To benefit from the colours inthe future, 
and benefit NOW from the extra features of 
SMSQ/E, here a special offer: 


SMSQ/E for the QXL | 


As Aurora owners will be able to use more colours 
when the colour drivers are available, another 
offer for SMSQ/E for the Aurora plu 
GoldCard/SuperGoldCard: 


SMSQ/E for the 
(Super)GoldCard 


only 1 


Offer now ends 30th of August 1998!!! 


Verbatim 3,5” DD Disk 720k 
Each only -,69 DM! 
Noname 3,5” DD Disk 720k 
Each only -,49 DM! 
Various colours!!! 


prices incl. 15% VA.T. (can be deducted for orders from 


non-EEC-countries). E&OE. Cheques in DM, £’s,: 
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Eurocheques and Credit Cards accepted. 


| 


an HTML browser (easy way to 
make a colourful page, as HTML 
allows us to specify the colour 
with a #RRGGBB format). Maybe it 
was my screen or the graphic 
cards, but right in the middle value 
is not enough to completely 
discern the new colour from the 
old one. It seems that 3/4 of the 
full range works better. 


> 


The colour codes are (still 24 bit, 
VGA divide by 4 each bytes): 
BFBFFE FFBFBF BFOOBF BFFFBF 
OOBFBF BFBFOO. 

| also tried to move the three 
top colours near the white back to 
ihe other colours, but with a value 
of 1/4 instead of 3/4, they looked 
the same as their nearest colours. 
Using the model of the cube plane 
for the new colours, | get a clear 
blue, a light pinky, a dark violet, a 
very light green, the ‘standard’ 
dark cyan, and a dirty yellow. May | 
say | do not like them too much... 
may be because of the dirty 
yellow and the very light green. 
But there is another 6 lying in the 
cube model: we have six edges 
connecting the six vertices of the 
normal colours, so what about set- 
ting the colour on the edge? One 
more time, half values didn’t dis- 
play well, but 3/4 was just perfect 
(l also tried 2/3, not good enough). 
| get a light blue (darker than cyan), 
a pink, a violet (dark magenta), a 
green going yellow (yellowish? like 
the young grass, well sort of), a 
green going cyan (or a cyan going 
green? well, in french the word 
would be ‘glauque’ but nobody will 
define it as a colour, due to a cul 
tural misinterpretation, it's a bluish 
green, as can be seen on the sea 
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near the beach of paradise island, 
usually in the lagoon..), and a gold- 
yellow. Probably due to the fact 
that you can always group two 
new colours with two old ones 
and still have a smooth gradation, 
hence allowing nice shading effect 
on things like buttons, this model 
for the time being has my prefe- 
rence. 


G 


The colour codes are (always in 
full 24 bits): OOBFFF FFOOBE 
BFOOFF BFFFOO, OOFFBF FFBFOO. 

| would gladly try any other 
repartition, so if you think that you 
have a better idea, let's share it 
with everyone! | think it’s time for 
at least the 16 colours! 

Ok, so, now, how can you use 
the new colours, if you do not 
number them... Well, that's the 
tricky part. You can, of course, 
assign them with a number, but as 
long as the QDOS call will only 


allow a plain colour in the range 
0-7, you won't be able to use 
them as the standard ones. But 
just remember that we are using 
the flash bit on the screen map. 
SO, all you have to do is set this 
flash bit when drawing your pixel. 
There are two ways to do this: 
either you directly write to the 
screen map (Bad, very bad, where 
is the screen map? what is the 
current resolution ... hey, is the ap- 
plication currently displayed. well 
you go back to the very hard 
days without the PE). or you use 
the PE! Yes, it's astonishing, but 
the PE fully supports the 16 
colours. Well in fact the basis of 
the PE is to use a direct encoding 
of the value to put through a mask 
on the screen. All you have to do 
is to raise the flash bit in your 
sprite/pattern (and also using a 
large mask, so as to let the flash 
bit go through). And to request 
mode 8, as | do not know of a lot 
of applications that do not use 
mode 4 (well it's understandable 
on a limited display of 512x256(4), 
but on a 800x600(4) this still 
allows mode 8 with a great 
400x600 resolution!) 

Email: jgrimbert@atos- group.com 
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Geoff Wicks Replies 


Opinions, even controversial opinions, are permitted in reviews, 
but facts are sacred. Your review of SOLVIT-PLUS 3 was 
marred by several factual inaccuracies. 


"The biggest failing I saw was the 
lack of any update to the manual". 

Not true. An upgrade sheet is 
provided with the program, and 
this sheet was enclosed with the 
review copy | sent to QL- Today. 

With upgrades | never produce a 
new manual, but a two page 
upgrade sheet reduced to fit on 
one side of A4. As any software 
producer will tell you, the manual is 
the highest single direct cost of a 
software product. Each copy of 
the Solvit-Plus manual costs about 


half my upgrade price to produce. 
It is also a capital cost. Disks can 
be made up on demand, but the 
manual cannot. | have to estimate 
the possible demand for a 
product, and order the requisite 
number of manuals. If | produce a 
new manual with every upgrade, 
then the cost of any unused old 
manuals would have to be 
charged to the upgrade. 

In practice this would mean that 
an upgrade would be double or 
even treble its present price. Do 
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we really want to return to the 
days when upgrades were sold as 
Special Editions’ with a 25% to 
50% price increase? 


SOLVIT-PLUS 3 "does not allow 
you to import a text file as a dictio- 
nary". 

Not true. An ASCII word list can 
be imported into SOLVIT-PLUS 3. In 
fact this part of the program was 
extensively rewritten to provide 
additional error trapping and more 
on-screen progress messages. 

Loading and importing dictiona- 
ries. which were two separate 
commands in SOLVIT-PLUS 2, are 
combined into one command 
“WORD LIST’ in SOLVIT-PLUS 3. 
This is not only documented in the 
upgrade sheet, but also mentioned 
on a help screen that your 
reviewer has clearly not read. 


"No new features were added". 

Not true. If full mouse compatibili 
ty, repositioning on high resolution 
screens and backwards move- 
ment through word lists are not 
new features, what is? In addition 
there are user configurable screen 
colours, a simpler user interface 
and the optional use of a forward 
slash in wild card searches, a 
feature many users have 
requested. 


"There are a few items that need 
to be done to get Solvit-Plus 3 
running.” 

Your reviewer then goes on to 
describe a complicated installation 
procedure. This is a fair criticism of 
the program, and | accept that 
insufficient help is provided on this 
point. The reviewer correctly iden- 
tifies part of the problem as being 
due to the program and default 
files being on disk 2 and the word 
list on disk 1. He is also correct in 
his assumption that you could 
make a bootable disk by copying 
these three files to one disk. The 
procedure for installing on hard 
disk is: 

1: Copy files Solvit3_obj and 
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Solvit3_def on disk 2 and 
English_dic on disk 1 to your hard 
disk directory. Let us assume this 
is “winl_solvit’ 

2: With disk 1 in your disk drive 
start the program via the com- 
mand 

EX wini_solvit_solvit3_obj; 
‘wini_solvit_' 

3: Press L for WORD LIST and 
reload the dictionary from your 
hard disk directory. 

4: Press P for Parameters, make 
any changes you wish, and then 
press D for DEVICE to save the 
new values. 

5: Use the QJUMP configuration 
program to change the default 
drive to ‘wint_solvit_’. 


"To keep development time down, 
it looks as if Geoff Wicks took the 
core part of Solvit-Plus 2 and moved 
that part to the Pointer Environ- 
ment version”. 

This is fair comment within the 
rules of reviews, but the reviewer 
is wrong in his assumption. 

The design of SOLVIT-PLUS 3 
was the result of extensive market 
research, which is a pretentious 
way of saying | talked to users of 
SOLVIT-PLUS 2 for three years. 
Two themes came out of these 
discussions. Firstly most users are 
using the program only for wild- 
card searches, and secondly there 
is a small group of purchasers 
who were overwhelmed by the 
number of commands. There was 
obviously a need for a simpler 
front end. 

Another factor affecting the 
design of SOLVIT-PLUS 3 were 
the demands of the pointer envi 
ronment. For ease and speed of 
use, particularly with a mouse, 
pointer programs are most effec- 
tive if the menu items are dis- 
played on screen alongside the 
application window. There was no 
room for all the SOLVIT-PLUS 2 
commands and sub-menus would 
have been necessary. Each sub- 
menu would add to the complexity 
of the program, and its memory 
requirements. The screen and 


menu routines already form over a 
quarter of SOLVIT-PLUS 3's me- 
mory requirements. 

| therefore took a decision to cut 
down the program to make it 
simpler and faster to use. Three 
features, Backwards, Palindrome 
and Figures are “once only” rou- 
tines for any one word list, and 
would remain available in SOLVIT- 
PLUS 2. The spell checking rou- 
tine was never intended to rival 
the dedicated QL spell checkers. 
and there was no evidence of 
widespread use. In addition a word 
list suitable for spell checking, 
especially in some non-English lan- 
guages, has some differences 
from a word list for word puzzles. 

In short SOLVIT-PLUS 3 was 
written more for existing users 
than new users. lt modernised the 
program to make use of some of 
the hardware developments of the 
last few years. SOLVIT-PLUS is 
over three years old, is a specialist 
program, and although it still sells 
slowly but surely, | am not expec- 
ting many new users. 

lf your reviewer is feeling a little 
bruised by this rebuttal, let me 
finish by saying that | agree with 
most of his last paragraph: 

"If you are a current user of 
Solvit-Plus and use the Pointer 
Environment, I would recommend 
getting version 3. Using the same 
consistent PE interface speeds up 
the program. If you do not use the 
PE then you are not really missing 
out on the new features." 


Tim Swenson responds to 

Geoff Wicks’ comments regard- 

ing the Solvit Plus 3 review: 
>"The biggest failing I saw was the 

lack of any update to the manual" 
>Not true. 

There is a good possibility that 
the Update sheet got lost when 
the package was sent to QL 
Today and then to me. Since 
Geoff says there is a sheet, my 
comments can pretty well be 
considered null and void. 
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>SOLVIT-PLUS 3 "does not allow 
you to import a text file as a 
dictionary". 

>Not true 

| must have missed this one. | 
think having the Update sheet 
would have helped, as Geoff 
mentioned. 

>"No new features were added". 

>Not true. 

| meant this to refer to the 
general use of the program and 
not the inclusion of the PE and 
user interface, 


>"To keep development time down, 
it looks as if Geoff Wicks took the 
core part of Solvit-Plus 2 and moved 
that part to the Pointer Environment 
version". 

>This is fair comment within the 
rules of reviews, but the reviewer is 
wrong in his assumption. 

My assumption was based only 
on what | saw and a whole lot of 
guessing. It can be hard to guess 
the WHY only seeing the WHAT. 

Tim Swenson 


Parallel Printer Interface Plus 


Adaptation 


Al Feng 


If you ever had mechanical problems with the old Miracle Centro- 
nics Printer Interface, then you'll find THE solution in this article! 


Many of you already know that 
MIRACLE SYSTEMS has _rede- 
signed their parallel printer inter- 
face so that its circuitry now fits 
safely within the confines of what 
would appear - from a distance - 
to be a standard, metal CENTRO- 
NICS plug. 

This is good news because if 
your experience with their old 
style parallel interface has been 
similar to mine, you may have had 
the misfortune of breaking the 
blue plastic, CENTRONICS plug 
away from both the black box and 
circuit board! 

Okay, the misfortune means one 
of a few things: 

1) 1am clumsy; AND, 

2) my printer is NOT well situa- 
ted; and/or, 

3} the design is unintentionally 
fragile. 

| finally decided - after “breaking” 
my parallel interface for the 
umpteenth time - that it was time 
fo find my ohm-meter, warm up my 
15 watt soldering iron, and make a 
short adapter cable that would 
allow me to employ a ‘standard’ 
IBM parallel printer cable. 
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After opening the interface box 
and looking at the short jumpers | 
had previously employed to RE- 
connect the CENTRONICS plug to 
the circuitry, it occurred to me that 
| might as well make a hard wire 
connection directly between the 
circuit board and a 25-pin D-sub 
(female) plug [NOTE: If you are not 
confident of your soldering skills in 
tight areas then should consider 
making an adapter cable]. 

You only need to make eleven 
(11) connections to the D-25 plug 
since there are only that many 
signals being used by the 
MIRACLE parallel interface. 

The main thing to note is that 
the presentation of the CENTRO- 
NICS: plug is the ‘front view" and 
D-25 is the ‘rear view’ of the plug. 


CENTRONICS plug ------ 
{front view] 


Kooo0o000000000G0000 


25 female plug ----- > 
[rear view] 


123456789012345678 


ABCDEFGHIoJooookkoa 


ig3dnt987654321 


ABCDEFGHITIoJoo 


Connect 'A’ to ‘A’, 'B’ to 'B’. and 
SO on. 

| used a solder-type D-connec- 
tor and eleven short (about @ 
long) pieces of multistrand wire. 

lf you are simply making an 
adapter then you may note that 
using IDC (ribbon-type) plugs 
should be much faster - only the 
ground (K’) connection needs to 
be ‘off-set’ with a jumper. 

If you are hard-wiring, look at the 
circuit board carefully and then 
decide where you want to make 
your connections - | chose to 
hard-wire directly to ‘pins’ on the 
circuit board - visually tracing back 
from the CENTRONICS plug to the 
first available pin. A hard-wire im 
plementation will minimize compo- 
nents. 

| twisted the wire together 
(loosely) and then wrapped the 
cluster (tightly) with electrical tape. 

Finally, | used my soldering iron 
to melt-away a small ‘cut-out’ in 
the back edge of the base of the 
interface’s black plastic box so 
that my short pig-tail adapter 
could exit the opposite end of the 
CENTRONICS plug. Take your 
time (test fit often}, and don't make 
the hole too large. 

Since my QL’s components are 
nestled inside a salvaged PClone 
case, my old style, MIRACLE paral 
lel interface can now rest near the 
back of the case (on the inside} 
out of harm's way with the 25-pin 
connector firmly attached to the 
rear of the case using an available 
opening intended for this type of 
connection. 

In addition, | can now employ 
ANY LENGTH of any ‘standard’ 
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| BlackKnight chess .. 


im stillen Winkel 12 ¢ 47169 Duisburg « Germany 
@ 0203~-502011 (Fax 0203-502012 Mailbox 0203-502013 & 502014) 
http://www.j-m-s.com/smsq/ email: smsq@j-m-s.com 


QL Games 


.DM 119,90 


| Arcanoid 
| Firebirds 


| Diamonds 

| The Oracle 
| MineField 

| Double Block 
| The Lonely Joker 2 . DM 59,00 
| SuperGamesPack .. 


DM 39,90 


.DM 90,00 


Keyboard membrane .. DM 25,00 


Ink for 
|EPSON-Printers 


Stylus 800 


| Stylus Color ii, Ils, 820 
| Stylus Color Il, Ils 
| Stylus Color 500,600 


QD Editor 

QD Upgrade from V8 ; 

FiFi {t File Finder [V4.16] ..DM 49,90 

FiFi Il Upgrade from previous Version DM 19,90 
[V4.21] . .DM 44,90 

QLiberator SuperBASIC Compiler .DM 139,00 

QLoad-Ref 

QLa 

QMAC Macro Assembler 


W143) .. 
AVON .. 


QTYP 2 Spell-Checker .. [V2.7]... 
QPTR Pointer Toolkit ... [V0.30] . 
QSpread Spreadsheet .. .{V143] .DM 169,00 
QSpread Update trom v1.34 or before ..DM 16,00 
QSpread Update trom Vi35-141... 0.0... free 
QSUP . DM79,90 
EPROM Manager . OM 6150 
.DM 49,90 
. .DM 99,00 
.DM 49,90 


Alternative s 


‘extremely good" 


ie tested 


Applications 

[V1.05) ...DM 65,00 
DISA Interactive Disass. . [V3.02] ..DM 95,00 
DISA V3 - Upgrade from Vi or V2... .DM 35,00 
EasyPTR Part 1+ 2 DM 99,00 
EasyPTR Part 3 DM 49,00 
Stylus-Driver for text87 and text91 . .DM 69,00 
HyperHelp for BASIC DM 44,90 
DiskMate 5 DM 69,00 
CueShell DM 95,00 
SERMouse Driver DM 29,00 
QDOS/SMS Reference Manual DM 84,90 
Update sheets from March 1997 ....DM 13,00 


ProWesS + Applications 


{all ProWesS Applications require ProWesS which is not included!) 
ProWesS WindowManager+HTML Reader . DM 129,00 
DataDesign Database 

LineDesign Vektor/DesktopPublishing 


fontutils 
PWfile 


Ink for 
unurertatets 


.. . Cyan or Yellow or Magenta .. 
. «+ black, Pack of 3 
.-. black, Pack of 3 

. colour, Pack of 3 


Stylus Color 500 
Stylus Color 800, 1520 
1 Stylus Color 600, 800, 1520 .. colour 
| Stylus Color 1500 
| Stylus Photo DM 36,90 
| Minimum order: 3 items (can be mixed)! 
TERMS OF PAYMENT 


Postage and anand [Germany] DM 8,99 (if total value of goods is up to DM 50, then only DM 5,99). [Europe] DM 14,50 (if 
i total value of di to DM 50,- then only DM 9,50). [Overseas] between DM 14,50 0 sere) and DM lah (maximum). All 


Minimum order: 3 items (can be mixed)! 


| non—-EEC-—countries}. 
Eurocheques and Credit Cards accepted. 


IBM printer interface cable to com- 
plete the connection of my QL to 
my printer (long IBM-type parallel 
printer cables tend to be much 
cheaper than a CENTRONICS-to- 
CENTRONICS cables of equal 
length; and certainly, easier to find 


in a store). 

Of course, | now enjoy the op- 
tion of either plugging directly into 
a parallel printer or employing an 
IBM-type printer cable as an 
extension. 

[Editor's note: | can tell from 


experience that you should not 
use cheap parallel printer cables 
longer than 5 metres, otherwise 
you may loose data - with 
high-quaity cables 8 metres were 
possible] 

Ee 


Electronics for QL Peripherals 


Part 2 - Reactive components 


Stuart Honeyball 


The first article in this series 
dealt with energy transfer from a 
current or voltage source to a re- 
sistive load where the electrical 
energy was turned into a different 
form and dissipated from the sys- 
tem. There are 2 types of reactive 
components - inductors and capa- 
citors - which store energy. 

The diagram shows a voltage 
source feeding an inductor (The 
symbol for an inductor also called 
a coil, reflects the physical imple- 
mentation which is simply a coil of 
wire often wound around a mag- 
netic core) 


In Figure 1 the current | wil 
increase steadily with time at a 
rate of WL Amps per second. in 
calculus terms the current is the 
integral of W/L with respect to time. 
Now imagine that switch SW1 ts 
flicked so that it short circuits the 
inductor There will be OV across 
the inductor and so | will now re- 
main constant flowing around the 
circuit loop made by SWI and L1. 
The energy stored in Li is 
(1/2)*12*L1 Joules. What would 
happen if SWi had a third position 
where Li was neither connected 
to VS nor short circuited? L1 
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would not have a complete 
circuit and so would not be able 
to pass any current. This means 
the current would have instantly 
gone from a non-zero value to 
zero which implies the voltage 
across it must be infinite! In 
practice this can not, of course, 
happen because real world induc- 
tors are not perfect - they have 
losses. The voltage would how- 
ever increase to a value substan- 
tially above VS and this effect is 
widely used to derive high vol 
tages from low voltage sources. 
In Figure 2 assume Li has a 
current | flowing through it to 


Pe 


_ begin with. 


6 it 
Voltage Li 
Generator 


s 
eet 
SOONG 


The voltage across Ri (and L1) 
is V and is simply given by Ohm's 
Law: V=IFRL. The energy comes 
out of the inductor Li and heats up 
the resistor Ri. The voltage will 
decrease at a rate of {/L1 volts per 
second. If V decreases then | also 
decreases and so both decrease 
exponentially over time decaying 
towards the asymptotic limit of OV. 

For the equivalent treatment 
given to a capacitor (the symbol 


Figure 3 
Biss eae uaa Nene 


shows the 2 conductive plates 
separated by an insulator) consi 
der Figure 3: 


V increases at a rate of I/Ci 
volts per second and the energy 
stored in Ci is (1/2)*V°2*C1. Now 
imagine the current source CS is 
switched off by flicking SW1. It 
may seem odd to switch off an 
energy source like this current 
generator by short circuiting it. 
Consider what would happen if it 
were set open Circuit: the voltage 
would rise to try to bring the 
current up to the rated level which 
would involve the generator 
producing its maximum voltage 
which could well be greater than it 
can safely deliver Shorting it 
causes zero voltage to be pro- 
duced and thus no energy is taken 
from itt Now back to the main 
storey. Ci is open circuit and not 
connected to anything so [=O and 
so V remains steady. The energy 
can be extracted from Cl by 
Closing switch SW2. The current | 
is given by -WR1 (negative be- 
cause it flows out of Ci the oppo- 
site way to which it went in) which 
causes V to decrease and so, like 
the inductor, both V and | decrease 
exponentially tending to 0 and the 
energy is transferred from the 
capacitor to the resistor and 
dissipated. Also note that short 
circuiting a charged capacitor can 
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cause high currents to flow 
through it which can cause 
damage. 

The maths gets even more 
difficult when an AC {alternating 
current = oscillating) rather than a 
DC (direct current = steady) cur- 
rent or voltage Is applied to these 
reactive components. For this rea- 
son | will simply state formulae and 
give the effective conclusions 
leaving out the derivations. The 
ambitious reader is welcome to 
work through the maths himself. 
Also, apologies for referring to AC 
voltages. Is is clear that voltages 
are not currents but this terminolo- 
gy is in common use. 

The simplest AC current or 
voltage is one where its instan- 
taneous level at any time tis given 
by A*SIN(2*PI*f*t+Phi) where A is 
the peak amplitude, f the frequen- 
cy in Hz (cycles per second) and 
Phi is its phase relative to another 
signal. It is usual to use w (lower 
case omega) to substitute for 
2*PlKf giving the frequency in 
radians per second. 

Apply an AC current to an induc- 
tor (Figure 4): 


Figure 4 


What is V? As stated earlier | is 
the integral of Vdt/L so V ts the 
derivative of | so V=L*(dl/dt). 

If FA*SIN(a*t+Phi) 

then V=A*L* w*COS(at+Phi) 

=A*L* ar SIN(aat+PhitPl/2). 

In other words the voltage 
waveform has the same sort of 
shape as the current with the 
differences being that it is w times 
bigger and leads the current by 
Pl/2 radians (a quarter of a period). 
Analysis shows that for half the 
time the inductor is taking energy 
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from the source and for the other 
half it is actually giving the energy 
back. Also when the current is in 
that part of the cycle when it 
passes though zero then the vol- 
tage is at its maximum and vice 
versa. Note that the circuit has a 
frequency related filtering charac- 
teristic. The voltage is proportional 
to frequency. If this were part of a 
hi-fi then it would give the effect of 
increasing the treble and reducing 
bass. Voltage or current genera- 
tors applied to iductive or capaci- 
tive loads exhibit both a +/-quarter 
period phase change and an 
increasing or decreasing ampli- 
tude versus frequency. 

Make a circuit from an inductor 
and a capacitor (Figure 5): 


up to a current of Imax and the 
capacitor fully discharged at OV 


The current will flow out of the in- 
ductor and charge up the capaci- 
tor As it does this the current will 
fall When the current has fallen to 
OA all the energy will be in the 
capacitor and the current will re- 
verse and start flowing back into 
the inductor causing the voltage 
to fall When the voltage reaches 
zero all the energy will be back in 
the inductor and the current will 
have reached its maximum nega- 
tive value, -Imax. The current then 
falls and charges up the capacitor 
to its maximum negative voltage 
then the capacitor loses its ener- 
gy to the inductor and it’s back to 
where it started so the cycle then 
repeats ad infinitum. Both the cur- 
rent and voltage give sinusoidal 
waveforms. It is interesting to note 
that for each complete cycle the 
current cycles once, the voltage 
cycles once but the energy is 
transferred backwards and_for- 
wards between the 2 components 
twice. The V and | resonant fre- 
quency in radians/s is 1/SQRT(L*C). 
To see whether you've being pay- 
ing attention or not work out the 
peak voltage magnitude in terms 
of Imax, L and C. 

a 


Q40 - More Hardware Details 


| Peter Graf 
SMSQ/E for the Q40 is still under construction, so this article 


continues with the description of some hardware functions. 


First an addition to the article 
about graphics hardware in the 
last issue. There were questions 
why the Q40 has an own graphics 
chipset, especially developed for 
the Q40, instead of a graphics 
card for Inte/PCs, for example 
from S3. This has a number of 
reasons: 

1. This is the only way to make 
the QL screen modes directly 
available. without software emula- 
tion, speed losses or possible dis- 
tortion of the aspect ratio. Writing 
directly to QL screen memory at 


address 131072 only works with a 
compatible hardware. 

2. The Q40 needs no new 
screen drivers for the QL screen 
modes. Writing drivers for the 
highcolour modes is simplified by 
easy initialization and addressing. 

3. Graphic cards for IntelPCs 
come and go in very short inter- 
vals nowadays and show large 
incompatabilties among  them- 
selves, even if they come from the 
same manufacturer. 

4, Performance is optimized by 
directly coupling the graphics 
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hardware to the bus of the 68040 
CPU, without detour to an Intel-PC 
bus system. 

5. The overall system becomes 
smaller 

Now something about sound 
generation. On the original QL the 
output was restricted to the artifi- 
cial sound of the coprocessor, and 
not much additional sound hard- 
ware was around. The Q40 main- 
board has the capability to output 
sampled stereo sound by a digital- 
to-analog converter This gives 
the user the possibility to hear 
speech or music in good quality, 
by connecting a Hifi system, active 
loudspeakers or a headphone to 
the Q40. 


a) 
x(t) 


b) 
x(n) 


DAC(t) 
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To explain how the sound out- 
put of the Q40 works, an example 
of a waveform is shown in figure 
ta. This could be a short section 
of a music or speech signal. The 
analog signal x(f) varies conti 
nuously over the time t. For sto- 
rage or processing on a computer 
the signal must exist in its digital 
form. The digital representation 
x(n) of the signal is a sequence of 
numbers, which contains the am- 
plitudes of the analog signal at 
evenly spaced points of time, as 
shown in figure ib. x(n) are sam- 
ples taken from x(t). The more 
samples are taken within a period 
of time, the higher is the maximum 


audio frequency and the more 
room for storage is needed. The 
Q40 uses selectable sample rates 
of 10 kHz or 20 kHz, so 10000 or 
20000 numbers give one second 
of sound. Instead of a single se- 
quence of samples, the Q40 uses 
two sequences, to independenily 
represent the left and right chan- 
nel of the stereo signal. (Of course 
it is also possible to output mono 
signals.) There are different possi 
bilities to use digital sound. Simply 
playing music, filtering and mixing, 
effects like distortion or echo, 
sound for games, electronical ge- 
neration of music, speech synthe- 
sis, and so on. How far the possi- 
bilities will be used depends on 
the application software. 

To output sound on the Q40 a, 
digital to-analog converter (DAC) 
is used. It converts the sequence 
of data into an analog signal as 
shown in figure 1c. As you can 
see, the waveform still contains 
steps like a staircase. For this 
reason an analog filter follows 
behind the DAC to smooth the 
signal and give it its original 
waveform from figure ta. Double 
DACs and filters exist on the Q40 
for the stereo signal. The DACs 
have a resolution of 8 bits, so they 
can output 256 different voltages. 
The Q40 provides the output 
signals in two different voltage 
levels, as a headphone output or 
as a LINE output for Hifi systems 
and active loudspeakers. Of 
course monitors with integrated 
loudspeakers can also be used. 
The audio DACs of the Q40 can 
be directly accessed at the 
addresses $FFOO8000 and 
$SFFO08004, but normally the 
sound drivers should be used for 
output. The Q40 generates hard- 
ware interrupts for sound output. 
To make programming as easy as 
possible, the Q40 does not include 
specialized sound chips _ like 
Soundblaster even though they 
are available cheaply. 
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The keyboard interface of the 
Q40 is not constructed to be 
directly connected fo a matrix 
keyboard. So a QL keyboard can 
not be used, the outline of the 
mainboard does not allow mount 
ing in a QL case anyway. There is 
a connector for MF-Il keyboards 
instead, which are current PC 
keyboards like those also used 
with some QL keyboard inter- 
faces. The keyboard informations 
are transmitted by a serial line, 
synchronous to a clock line. Data 
and clock signals, together with 
the power supply are on a 5-pin 
DIN connector The Q40 converts 
the serial keyboard data into an 8 
bit parallel signal. By the way, the 
data from the keyboard does not 
directly represent the letters, but 
contains so-called Make- and 
Break- codes. They signal the 
events of pressing and releasing 
single keys, ignoring — their 
language-specific meaning. For 
example the key Z on a German 
keyboard has the Make-Code 53 
and the Break-Code sequence 
240, 53. On English keyboards 
these codes stand for the letter Y 
The MF-ll keycodes are not 
relevant to the user, because they 
are interpreted on the lowest level 
by the keyboard driver of the 
operating system. 

The series production of the 
Q40 has not yet started, because 
the adaption of SMSQ/E still goes 
on. But single prototypes without 
Operating system are already 
available for firmware developers. 

For those who wait for the 
68060 mainboard, it should be 
said that a prototype with 50 MHz 
clock frequency is already work- 
ing in test operation. But it is 
doubtful that this version will ever 
be produced, because Motorola 
has already released ordering 
information about the 66 MHz and 
75 MHz CPU's and hopefully wil 
start series production of these 
new chips soon. 

@ 
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Letter-Box 
pea H.PHuyg writes: 


How not to format a 
hard disk. 

In a previous article | have been 
moaning about chicken and feeders. 
Upon reflection it should not have 
been chicken, but geese. For the 
innocents among us a keyword 
could be: pate de foie gras. Why? 
Look at the logic to format hard 
disks in the QXL/QPC environment. 
In the last couple of years there have 
been some ‘improvements’ to that 
function, which are stuffed down our 
throats, whether we like it or not. 


1. You can no longer format a 
hard disk within a (BASIC) pro- 
gram. Now you have to give a 
‘WIN_FORMAT’ command first. Fair 
enough, why not 20 commands? 
But then you have to enter some 
random letters to proceed with 
the ‘FORMAT’ operation. | suspect 
that some time ago some fool 
initialized his or her hard disk by 
mistake. This can happen to every 
one. Now, what is the difference 
with a disk crash? One should 
have made provisions for backup 
and restore facilities anyway. Do 
we have to enter a random num- 
ber to prevent a crash? You might 
wonder why on earth one would 
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288 TO BBC KIT 


PAYMENT BY CREDIT CARD OR CHEQUE PLEASE 
POSTAGE UK UP TO £5. EEC £15. USA £20, OTHER COUNTRIES £30. 
ALL THE STOCK IS WARRANTIED FOR S80 DAYS. IN THE EVENT OF REPLACEMENT 
BEING ARGREED, BUT THE ITEM BEING OUT OF STOCK AT THE TIME, A REFUND 
WILL BE MADE PROVIDED THE ITEM IS RECEIVED IN GOOD CONDITION. 
QL & PC COMPUTER USERS WILL FIND THE CAMBRIDGE Z88 ESPECIALLY USEFUL FOR WORK AWAY FROM 
THE DESKTOP, WITH TRANSFER PROGS DATA CAN BE SAFELY EXCHANGED WITH THEIR DESKTOP SYSTEM. 


W.N.RICHARDSON & CO CONTINUES TO PROVIDE FULL SPARES AND 
SERVICES FOR SINCLAIR COMPUTERS, OL & THE CAMBRIDGE 788 
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need to format a hard disk by 
program. So did |. But then | HAD 
to write a utility (QCopier’, now 
donated to QUANTA} to copy files 
from/to QXL and PC. And it 
appeared that SMSQ etc does not 
like somebody else tampering 
with its hard disk units. And then 
the automatic formatting seemed 
useful. 

2. QPC now proudly presenis its 
ability to format hard disks in no 
time. | grew immediately suspr 
cious. No time means: nothing 
done. And so it is. If you think the 
contents of your files have been 
erased after formatting, you are 
wrong. The files are all there with 
all their little secrets. Basically, just 
the File Allocation Table (FAT) and 
the Main Directory are initialized, 
nothing else. Why am | not happy? 
A ‘winx_’-unit on the QXL/QPC is 
just a file on the PC. If | assign say 
a LOOMByte win-unit, that is a 
100Mbyte file, although | have 
used effectively only 40 Mbyte. 
When | do my backup on my PC 
on a tape-cartridge (| have written 
two years ago about it in QL- 
Today) then the standard backup 
utility uses compression. With the 
above ‘improvement’ in formatting 
(done only ONCE}, EACH time my 
backup takes up to 25 times 
longer than in the past. This, 
because the old ‘FORMAT’ did 
write always the SAME informa- 
tion to each sector, and compres- 
sors react by writing only once 
and referring to it. 

| was going to be very rude, 
referring to the introduction, but 
let me just finish with: ‘Oh Father, 
please forgive them, for they 
know not what they do’. 

PS. To my opinion ‘FORMAT’ 
should not be part of the Opera- 
ting System, it should be a sepa- 
rate Utility Program. 


Marcel Kilgus replies: 

1. The WIN_FORMAT is. very 
useful and it was requested by a 
number of customers. You can't 
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please everybody, but it has 
saved many people from loosing 
harddisk contents. Especially if 
you use removeable drives (this is 
why if was acutally implemented) 
you can imagine how easy it is to 
type FORMAT wini_ instead of 
win2_. 99% of the normal work is 
done on wint_, so it is quite easy 
to type wini. if you want to 
format win2_ WIN_FORMAT pro- 
tects you from doing this. | hope 
you are aware that you can add 
FOR x=1to 8WIN_FORMAT x 

to your BOOT file and you're 
back to how it was before - 
where is the problem? 


2. Again, one can't please 
everybody. Many people com: 
plained that formatting 1MB of ZIP 
took about 42 seconds - which 
was really slow when you for- 
matied 100MB or so. The solution 
which exists now has pleased 
everybody except for you so far 
lf | remember correctly, there has 
been an article in QL Today which 
told you how to cut down 
QXLWIN files to the currently 
used size, as QPC will make it 
grow automatically if required (it 
may have been in a German 
issue). 
| 


Indenting BASIC Programs 


Dilwyn Jones 


SuperBASIC is a highly struc- 
tured language. By avoiding the 
use of GOTO and GOSUB com- 
mands in your BASIC programs, 
you can use procedures, loops, 
functions, multi line IFs and 
SELects to write programs which 
are easy to follow, since courses 
of action and program branches 
can be clearly followed, as they 
have defined start and end points, 
rather than the arbitrary start and 
end points of program branches 
made with GOTOs. | am not 
against the use of GOTOs by con- 
senting adults in private, of course, 
but where it is used, it is best used 
only for short jumps less than a 
screentul of lines apart from each 
other, so that you can see the ori- 
gin and destination of any GOTOs 
in a single edit screen. 

Another technique available to 
the SuperBASIC (and SBASIC) 
programmer is indenting pro- 
grams. What this means is that 
spaces can be placed before 
certain lines in a program, allowing 
code contained within loops, for 
example. to be displayed further 
to the right than the bounds of the 
loop. Here is an example: 


100 LET number = 1 
110 REPeat loop 
120 PRINT number 
130 LET number = number + 1 
140 IF number » 10 THEN 
150 PRINT'PROGRAM FINISHED. ! 
160 EXIT loop 
170 END IF 
180 END REPeat loop 

This short example BASIC pro- 
gram just prints a few numbers by 
counting up within a loop. There is 
nothing wrong with it as it stands, 
but | hope that by repeating the 
listing with structures (loops and IF 
Statements) indented with a few 
spaces, | hope you'll see that it will 
be a bit more readable than the 
above example. 
100 LET number = 1 
110 REPeat loop 
120 - PRINT number 
130 LET number = number + 1 
140 IF number >» 10 THEN 
150 PRINT'PROGRAM FINISHED. ! 
160 EXIT loop 
170 END IF 
180 END REPeat loop 

lf you type a few spaces bet 
ween the line numbers and the 
rest of the line, SuperBASIC re- 
members those and this technique 
is quite useful - | write all my pro- 
grams indented like this. It's also 
common practice among profes- 
sional programmers. Modern 
programming tools often perform 


QL foday 


SA) ProWesS is a new user environment for the QL. 
ProWesS is short for "PROGS Window Manager", Z 
but it is much more than that. Apart from a new een Pacis S afplicalion 
WY window manager, it contains all the system 
‘ extensions from PROGS, and is essentia! if you: 


want to run programs which need these a powerful and VOY BEE 
extensions. 


The ProWesS reader is a major part of the! frvendly file: J 

package. It is a hypertext document browser. This tA we a sal 
means that text files which include formatting 
commands (including pictures) and possibly links) : 


to other files can be displayed and read in this| |[yakedohelpBProWesS file manazerMquitZ: 
=, ! 


program. This is used in ProWesS to read (and 


possibly print) the manuals, and display the help} ection: *Filslnfo link include subtree: 
files. The hypertext documents which are used by) [bert methed: Faone (game ae on disk) Cormmands| 
the ProWesS reader are in HTML format, the encions : eshyef a Not! 
format which is popular on Internet to display paieirgecce A Not, 
World Wide Web pages. ectory > WINL app files S: Tree All) 
Another important aspect of ProWesS is the i: RAMI <- Ruchange! 
possibility to allow programs to automatically “PWELIS 6 OO a 
install themselves on your system, and to be able ; 233daB 1997 aot 21 13:23) 


to run them without resetting the system. This 
means that, when you get a new program, ail you : 
have to do is insert the disk and indicate "start the| menutil_h 
program in flp1_", a menu option in the "utilities") | |delete_c ordes_c 
button. To install a program, you indicate ‘install| |jenglish_c tename_¢ action_h 
software", and the software can be added to your! |/menutil ¢  fileinfo « action ¢ 
system. This way, you don't need to know how to) | = = = 
write a boot file to use the multi-tasking 
capabilities of your computer. 
ProWesS includes many programming libraries. ° 
These include syslib, an interface to the operating LIN Edes Ign 
Aen: Ader edilgi neon aren pa Create artistic drawings, technical drawings, process bitmaps 
(via a printer driver). The DATAdesign engine is| (even scale and rotate them!), and any kind of vector 
also part of ProWesS. It is a relational database drawings. You can use grpahics objects to create the most 
system with a bonus, as you don't even need a fabulous drawings ever seen, Because LINEdesign is a vector 
key field, You get a powerful record at a time data; 2'@wing program, any part of the picture can be moved, 
manipulation extension to the language you scaled, rotated, slanted without any loss of precision or 
already use. Of course it also includes ProWesS resolution. In LINEdesign, pictures are device independant, 
itself, the new resolution independent window) Meaning that the printout will be the same on any printer (e.g. 
manager, same size and position). ; : j 
LINEdesign is good at handling text. You can easily put titles 
Easy to use program to create listings on any | and tull paragraphs on the page. All the fonts can be displayed 
printer (especially inkjet and laser). This ProWesS | at any size, rotation, etc. All the fonts which are available to 
: <2) application allows you to indicate the files which | ProWesS can be used in LINEdesign. 
pocnd have to be printed. Each column contains a footer | LINEdesign is a drawing program, but it can also be used by 
which can include the filename and filedate. The| people who are not good at drawing. LINEdesign is a great 
Lo, listings always allow perforation. PFlist can create | program for making leaflets, posters, and any kind of printed 
your listings in two columns and in landscape (or | work. Lots of clipart and extra fonts are available from public 
QW. both). eal oe and BBS's. You can even import Adobe 
lustrator files. 


phical Software 
P 


File search utility with many useful options, like 

the choice i eran only ae ae a certain 
extension, and whether or not the directory tree , 

has to be scanned. All occurences of the DATAdes Ign 

searchstring will be displayed with line number or : th er 

offset. You can also use special matching Never before has it been so easy to create, fill in and maintain 

r=9 features, like case dependent, matching a space | Your personal databases. To start a new file, just type the 

with a stretch of whitespace, and searching for a | Names of the fields. To add or delete a field, no problem, just 

“=. word dilimited string. 3 it. To rr aii etl "a a ene re sbatpreee it. ty ad 

: F choose which fields are displayed and also which records. You 

ont- Heche your igi iia Mermaid rio can have a hidden comment for each record, look at the file in 

TS Os Berl see What cud Ae tabulated form and transfer data to the scrap or hotkey buffer. 


* font and convert Adobe Type 1 and similar fonts | Figg oan be memor F 
: y based (for speed) or disk based (for 
utl l S for use in ProWesS. safety). ( 3 ( 


earch 


Wy Dr. Fr. Hemerijckxlaan 13 /1 i : aac Oe a 
dd ax + 

new a TESS <- Samu email : joachim@club.innet.be 
- www : http://www.club.innet.be/~year2827| 
ProWesS - BEF 2400  DATAdesign - BEF 1200 PWfile - BEF 900 PFlist - BEF 600 
Payment terms : LINEdesign - BEF 1200 fontutils - BEF 1200  fsearch - BEF 600 


You have to run ProWesS to make LINEdesign, DATAdesign, fsearch, fontutils Postage ‘ Costs of postage and packagin, have to be added. 
and PFlist work (even though DATAdesign uses wman). You can choose the quality. Rate depends on no of programs. 


All our software is normally supplied on high density (HD) disks. However > r ; ; 

they can be obtained on double density (DD) disks at an extra casts of BEF priority mail ordinary mail 

1CC. To use ProWesS and any of our other packages, you need a system with at | copies Belgium Europe World |'Belgium Europe World 

least 2MB of memory. You should have a harddisk although a two disk system ed ; 

will also work. The use of SMSQUE is strongly recommended for optimal usc of | One 100 200 240 100 120 | 145 

ProWesS. 3 4 

If you are VAT registered (specify registration number) or live outside the EEC, Ea 135 340 420 135 190 230 

the amount to be paid is the total (including postage) divided by 1.21 (nanced | 3 or4/} 160 560 770 160 310 395 

fopay too much). cureChests ia BEE or ty VISA Emocard or | 2002|| 185 870 | 1250] 185 | 550 | 705 
ayment can lone by EuroCheque in , or by , EuroCard or - 

MasterCard. Credit card orders can be handled by phone. For credit card, | MOTe 295 1130 | 1610 | 295 800 | 1030 | 


please specify name of card owner, card number and expiry date. All prices are in BEE including 21% VAT 


} 
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100 REMark INDENTING BASIC PROGRAMS 

110 MODE 4 

120 WINDOW 448, 202,32, 15: WINDOW#2, 448, 200, 32,16 

130 WINDOW#0, 448,40, 32,216: CLS#0:BORDER 1,255:CLS 

140 CSIZE 0,0:PRINT FILL$('-',74) 

150 CSIZE 2,1:PRINT' INDENTED BASIC PROGRAM LISTINGS' 

160 CSIZE 0,0:PRINT FILL$('-','74) 

170 PRINT\TO 21;'Copyright (C) Dilwyn Jones, 1990! 

180 REPeat get_filenames 

190 INPUT\'Indent which program?'; inp$ 

200 IF inp$='' THEN EXIT get_filenames 

210 INPUT'Print to where (e.g. ser1)?';out$ 

220 IF out$='' THEN EXIT get_filenames 

230 IF NOT(inp$==out$) THEN FXIT get_filenames 

240 BEEP 5000,70:PRINT'Names must be different! ' 

250 END REPeat get_filenames 

260 IF inp$='' OR out$='' THEN AT#0,1,0:PRINT#O, ‘PROGRAM FINISHED.':WINDOW 448,200, 32,16:STOP 

270 REPeat get_filenames 

280 INPUT\'Indent by how many spaces per step (0 to quit)?';spaces 

290 IF spaces>=0 THEN EXIT get_filenames 

300 BEEP 5000,70:PRINT' Invalid entry!'! 

310 END REPeat get_filenames 

320 IF spaces=0 THEN AT#0,1,0:PRINT#0, ‘PROGRAM FINISHED. ':WINDOW 448,200,32,16:STOP 

330 PRINT\'Indenting, please wait...'\\ 

340 OPEN_IN#3, inp$ 

350 OPEN_NEW#HA, out$ 

360 indent=0 

370 REPeat get_lines 

380 IF EOF(#3) THEN EXIT get_lines 

390 IF INKEY$=CHR$(27) THEN PRINT'<ESC>':EXIT get_lines 

400 INPUT#3, in_Ine$ 

410 backwards=0 

420 space=' ' INSTR in_lne$ 

430 out_start=space 

440 REPeat unspace 

450 IF in_lne$(out_start)<>' ' THEN EXIT unspace 

460 out_start=out_start+1 

470 END REPeat unspace 

480 out_Ine$=in_lne$(out_start TO ) 

490 IF ('DEFine ' INSTR out_lne$)=1 THEN indent=indent+spaces:backwards=spaces 

500 REMark checking for the colons in the following lines allows suppression of indents for short forms 
510 IF ('REPeat ' INSTR out_lne$)=1 AND (':' INSTR out_lne$)=0 THEN indent=indent+spaces: backwards=spaces 
520 IF ("FOR ' INSTR out_lne$)=1 AND (':' INSTR out_lne$)=0 THEN indent=indent+spaces:backwards=spaces 
530 IF ('SELect ' INSTR out_lne$)=1 AND (':' INSTR out_Ine$)=0 THEN indent=indent+spaces:backwards=spaces 
540 IF (‘WHEN ' INSTR out_lne$)=1 AND (':' INSTR out_lne$)=0 THEN indent=indent+spaces: backwards=spaces 
550 REMark I use the next line for the Turbo pseudo-keyword WHEN_ERROR 

560 IF ('WHEN_ERROR ' INSTR out_lne$)=1 AND (':' INSTR out_lne$)=0 THEN indent=indent+spaces: backwards=spaces 
570 REMark in the next line, an unconditional NEXT is most probably the end of a FOR loop rather than part of a 
REPeat loop 

580 IF (‘END ' INSTR out_lne$)=1 OR ('NEXT ' INSTR out_lne$)=1 THEN indent=indent-spaces 

590 IF ('ELSE ' INSTR out_lne$)=1 THEN backwards=spaces:REMark multi line IF statement 

600 IF LEN(out_lne$)>5 THEN 

610 REMark look for multi line IF - will fail if THEN omitted 

620 IF (‘IF ' INSTR out_lne$)=1 AND out_lne$(LEN(out_lne$)-4 T0)=='THEN ' THEN 

630 indent=indent+spaces: backwards=spaces:REMark simple single line IF...THEN 

640 ELSE 

650 REMark try for single line IF... without THEN - it normally won't have a colon 

660 IF (‘IF ' INSTR out_lne$)=1 AND (‘THEN ' INSTR out_lne$)=0 AND (':' INSTR out_lne$)=0 THEN 

670 indent=indent+spaces: backwards=spaces 

680 END IF 

690 END IF 

700 ELSE 

710 IF (‘IF ' INSTR out_Ine$)=1 THEN indent=indent+spaces: backwards=spaces:REMark VERY short form of IF! 
720 END IF 

730 total=indent-backwards: IF total<0 THEN total=0 

740 done$-FILL$(' ',6-space)&in Ine$(1 TO space)&FILL$(' ', total) &out_lne$ 

750 PRINT done$: PRINT#H, done$ 

760 END REPeat get_lines 

770 CLOSE#3:REMark input file 

780 CLOSE#4:REMark output file 

790 AT#0,1,0:PRINT#0, ‘PROGRAM FINISHED. ' 

800 WINDOW 448,200, 32,16:REMark restore default window 

810 STOP 
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this indenting automatically. Its ad- 
vantage is that properly done, 
indenting allows you to see some 
types of structural errors at a 
glance. If you indent anything 
within loops or IFs, the corres: 
ponding END IF or END REPeat will 
have the same level of indenting 
as the start of the structure, if not, 
you'll be able to work through it to 
find the point at which thingts have 
gone wrong, e.g. you may have 
one less or more END IF than IF 
statements. This causes errors 
when your program runs. An IF 
statement which fails in this way 
can mean your program can just 
stop without explanation, or give a 
misleading error. 

As ordinary SuperBASIC pro- 
grams are stored as simple plain 
text files, it makes it quite easy for 
this program to read it in, analyse it 
and write it out with added spaces 
to indent the listing. Run this pro- 
gram, enter the filename of the 
source BASIC program, where to 
write it out to (this can be a printer 
port name such as SERt or PAR if 
you just want an indented listing, 
or a filename if you wish to create 
an indented copy of your BASIC 
program), and finally enter a num- 
ber indicating how many spaces 
to add for each level of indenting. | 
normally use one or two. The 
higher the number you enter the 
better the indenting, but deeply 
nested loops will shoot off to the 
right and be harder to read, so 
high values become counter pro- 
ductive. 

Try the program on itself - if you 
typed in the listing correctly, it will 
correctly indent itself to show you 
what it can do! We set this from an 
original listing, which we know 
worked, so heopfully there will be 
no errors in this listing! 

| wrote the following program to 
indent SuperBASIC programs as 
described above. As it's only a 
short SuperBASIC program itself, 
it won't cope with all possible 
situations and will occasionally get 
it wrong, leaving you to correct 
the indenting by hand. Properly 
structured programs should be 
treated correctly. 

4 
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First things first. | would like to 
extend my thanks to Frank Davis 
and all the other people who 
organised the U.S. show in May. 
This was another good show and | 
enjoyed it thoroughly. A special 
mention must go to Kevin Mack- 
everly who purchased Aurora / 
Qplane / SuperHermes etc and 
proceeded to build his tower case 
at the show. Not only did he get it 
all assembled but he had it running 
by the time we packed up. Ano- 
ther special mention must go to 
Jim Hunkins who organised trans- 
port for Jochen, Tony Firshman 
and myself and also booked the 
hotel for our three day break in 
New York. Thanks Jim! 


A New Paragraph 

One of the things that we were 
shown at the US show was 
Francious Lanciault's new word 
processor, ‘Paragraph’. This is 
written to use the ProWesS sys- 
tem and it is clearly going to be a 
very good package. It is currently 
in Beta test version and there are 
some things that do not work yet 
but the things that do work are 
very good indeed The program 
will not be available for release for 
at least three months but, in its 
current form, it can use all of the 
ProWesS fonts, print in colour if 
the colour printer drivers are used 
and use graphics tn _pic, _ldp and 
gif formats. This is going to be a 
goodie. 


The Floppy on my 
Laptop! 

Continuing on from the mentions 
of the ‘other system’ in last issue's 
column | have recount something 
which happened to me. | have 
been running a series of beta 


copies of Windoze 98. Many peo- 
ple think this is suicide for a 
system but since | refuse fo use 
Windoze for anything but internet 
access | really don't care if it 
crashes (what do | mean ‘if'?}. One 
thing that hardly gets used on a 
modern PC is the disk drive be- 
cause PC programs and files are 
usually so bloated that you can’t fit 
them on to a standard HD disk, so 
tt was not until | tried to sort out a 
mouse driver for a friend of mine 
that | found out that the disk drive 
on my laptop did not work. It 
worked fine from QPC and from 
the native DOS but, as soon as | 
ran Windoze, it refused. After a 
week of searching through dlls, 
re-installing Windoze, and running 
diagnostic programs which all said 
‘This device is working properly’ | 
finally asked a friend of Steve 
Hall's who knows a lot about this 
kind of thing. He asked if | had a 
virus checker. ‘Of course | do’, | 
said. ‘Turn it off then’, he replied. It 
all seemed illogical to me but | 
tried it and the disk drive sprung 
back into life. It seems that the 
virus checker is designed for 
Windoze 95 and thinks that Win- 
doze 98 is a virus. It all made 
sense! Windoze spreads from 
computer to computer when you 
don't really want it, it makes it 
crash a lot and you lose data! Tell 
the world to beware, Windoze is 
not an operating system - it is a 
Virus. 


Don't Try This At Home 

In recent weeks | have found 
two foolproof ways to desiroy 
QPC so | thought | should pass 
these on to save other people 
from having similar problems. The 
first came from a customer of mine 
who had a hard disk crash on him 
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and lost his QPC installation. He 
decided to use the second instal 
lation and, having had a problem 
reported when he tried to read it, 
he thought he would check the 
disk first fo make sure it was OK. 
He ran Scandisk from the PC 
which told him there was an error 
on the disk and asked if he would 
like it fixed. ‘OK’ --- and there goes 
the disk. When he ran the instal 
lation program he got ‘illegal Copy’. 
This is because scandisk altered 
the master disk and then QPC 
thinks it is an illegal copy so this is 
one thing you should never do. 
Another good way to destroy 
your QPC installation is to convert 
the master disk from 16 bit to 32 
bit without first removing QPC. 
Converting the File Allocation 
Table is something you should 
consider carefully if you run a lot 
of older or DOS based programs 
but if like me, you only run a few 
modern PC programs and use it 
mostly as a QPC platform it could 
be worthwhile. The speed in- 
crease and the amount of disk 
space freed by this action make it 
very worthwhile. FAT 32 is only 
available on later versions of Win- 
doze 95. 


Iconography 

| recently received a letter from 
Mr WJ. Henry renewing his sub- 
scription to this magazine. He said 
‘Keep up the good work but with 
less emphasis on trying to make 
QLs compatible with the PC, 
complete with Windoze, ltchcons 
(incomprehensible), infestation of 
meeces and pointless pointers.’ 
(his spellings). | wanted to reply to 
this here because it is a subject 
which | have touched on before 
and fundamental to the develop- 
ment of our system. On the whole 
QL programs which use the Poin- 
ter Environment do not rely on the 
use of a mouse - they just enable 
it For many people, and | am 
definitely one of these, a mouse is 
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very useful and aids my produc- 
tivity by there others for whom if 
iS an annoyance. On the PC many 
programs will not work without a 
mouse or become very hard to 
control because the mouse is not 
controlled by the cursor keys as it 
Is on our system. As far as | know 
99% of pointer driven programs on 
the QL are able to be controlled 
without ever touching a mouse 
because all of the commands 
have keypresses will which acti 
vate them or at worse, function 
keys which will pull down menus 
that are controllable by the cursor 
keys. Some people find the mere 
presence of icons off putting and | 
am pleased that many program- 
mers are using removable toolbars 
so that these are not so intrusive. 
With regard to compatibility with 
the PC this is something which 
should be encouraged. Many peo- 
ple have left the QL because they 
cannot access files from their 
friends or workmates and any- 
thing that we can do to enable this 
form of compatibility is fine by me. 


Wherever you may ROM 

There may be several people 
out there who have had problems 
with their RomDisqs and they will 
be pleased to hear that the cause 
of the problems has now been 
found and corrected. It seems that 
there was a de-bugging routine 
that was used while developing 
the driver for the RomDisq and 
part of this was inadvertently not 
removed in the released version. 
Every now and this code would 
pop up and then make a call to 
part of the system which was not 
there - result: lock up. 

This code was removed in v2.11 
but then, when Tony confidently 
sent me the new version | got the 
dreaded ‘howling sysmon_ syn- 
drome’. A quick fax to Tony Tebby 
solved this and resulted in v2.12 
and the cryptic fax saying ‘Ah this 
is a bug ina fix of a fix of a fix of a 


problem that occurred on Minerva. 
| have now fixed the fix of a fix of 
a fix and it should be OK’. | am 
pleased to report that it is. 

The new version has the ability 
to load in ROM images and 
LRESPR files which are called 
ROMI, ROM2, ROM3, ROM4. | wan- 
ted this feature so that | could put 
the SuperHermes code onto it 
and have the keyboard instantly 
available in order to be able to test 
programs directly from their mas- 
ter disk with nothing else loaded. It 
Is also good to be able to run The 
Knight Safe that way to maximise 
the available memory. 

It was only when | was asked to 
set up a RomDisq for a customer 
with QPAC2 etc on it that | realised 
how good this little device was. | 
plugged it into a standard QL with 
a Super Gold Card and a set of DD 
drives and set up the boot file for 
SMSQ/E, QPAC 2, Text 87 etc. 
When | rebooted to check the files 
| was amazed at the short time it 
took to boot up. If you have no 
hard disk check this out! 


Reasons to be Cheerfull 

One little ray of sunlight that has 
entered into things this week oc- 
curred during a disaster which 
befell my wife’s laptop. After her 
hard disk failed recently | attacked 
the thing with a screwdriver and, 
after hunting up a new hard disk, 
installed it into the heart of the 
machine. Of course nothing is sim- 
ple in ‘PCland’. You first have to tell 
the BIOS what disk it has. after 
poking and prodding the BIOS for 
some hours | finally convinced it to 
look at the disk and to get the 
thing formatted and ready to re- 
ceive the new backup. 

Here in the real world of QDOS / 
SMSQE Phil Borman’s clever little 
Qubide just takes a quick look and 
says ‘ah its one of those, OK’ and 
you are off. 

The qlusers section of the 
majordomo list has been active 
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again this month and there are 
reports the Phil is working on 
ATAPI support for Qubide. Don't 
get too excited over this because 
it wil not mean automatic support 
for all ATAPI drivers (although the 
LS-120, a 120Meg disk that thinks 
itis a floppy disk and can read HD 
and DD disks as well, would be 
very welcome} but we are moving 
in the right direction here. 


Major Jump 

By the way | should apologise 
for misleading a few people about 
the way to log on to the qrusers 
list. When this list was first origr 
nated | was automatically enrolled 
and | had no idea how to do it. | 
misread some of the instructions 
and | am indebted to ‘Spike’ of 
Loughborough University for put- 
ting matters straight. The correct 
way to log onto this list if you have 
email access is to send a mes- 
sage to ‘majordomo @nvgntnu.no’ 
and put the words ‘subscribe 
qlusers’ into the message box. 
that will put you onto the best ql 
mail list in existence. Equally 
‘unsubscribe glusers’ will allow 
you to exit. 

| apologise unreservedly to all 
those who | have previously mis- 
led. 


No Chips With Anything 
You may remember that we 
have a few Super Gold Cards and 
QXL lying around here waiting to 
be used and that they hare all 
lacking one component - namely 
the ALTERA EP1810LC-25T chip 
that is used as the Super Gold 
Card INGOT and the QXL GLUE. 

In the last issue | mentioned the 
problems that we had been having 
with these items and fortunately 
the manufactures agreed to take 
the chips back and | was then 
back to square one. 

Just recently we again thought 
that we had solved the problem 
when one of my suppliers said 
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that there were some available 
from the US. | eagerly awaited 
their arrival and | had hoped jo be 
able to tell you that the last SGCs 
and QXL would be available soon. 
Well the chips arrived and we 
found that they were already pro- 
grammed - but for some other 
device! Since these are one-time 
programmable that was that. Ano- 
ther false trail. We are stil working 
on this problem and there will be a 
solution. If any of you are involved 
in the electronics industry and 
think that your company may have 
a few of these devices available 
do call us. 


offer three choices. The first 
choice is to update a file and this 
will offer a files menu to choose 
the file to be updated. When you 
select a file with a ‘DO’ or ‘ENTER’ 
it will load menuconfig, updated 
the file from the ‘menuconfig_inf' 
file and then quit all by itself. 

The second choice offers to 
Start menuconfig with a file alrea- 
dy loaded for configuration by a 
similar method to that above. 

The third choice will start menu- 
config alone. 

lf you have menuconfig on a 
button in your system and you 
replace that with this program you 


100 REMark Program to select a file and start 
Menuconfig with it loaded or update it 


110 DIM A$(2,25) 
120 A$(0)='Update File! 


130 A$(1)='Configure File! 
140 A$(2)='Start Menuconfig! 


150 A=LIST_SELECT('Action',A$,,,,,50,400,-1) 


160 SELECT ON A 170 =-1: 
EX wini_progs_Menuconfig; "\U 


180 =0 : getfile : 
"SFileF&" \Q" 
190 =1 : getfile 


stop 


: EX wini_progs_Menuconfig;File$ 


200 =2 : EX winl_PROGS_MENUCONFIG 


210 END SELECT 


220 DEFine PROCedure Getfile 
230 file$=FILE_SELECT$('Menuconfig 
Select', »WIN1_PROGS_, 3993 13 -1) 


240 END DEFine 


A Little Code 

Just as an example of the kind 
of thing QL Today Is looking for in 
the Hot Tips and Odd Procedures 
section | am including a bit of 
BASIC that | put together because 
| wanted to update programs with 
Level 2 config blocks. This relies 
on menu_rext being LRESPR’d 
and menuconfig being available 
and you should change the follow- 
ing lines to suit your system: lines 
180/190 should show the location 
of menuconfig line 230 should 
give a target directory. See the 
listing above. 

When this program is run it wil 


will have a more flexible way of 
using this facility, 


The Book 

| have just spent a weekend 
with Rich Mellor putting the 
finishing touches to the 
manuscript of the SBASIC / 
SuperBasic Reference Manual. By 
the time you read this we should 
be able to quote a price and offer 
the manual for sale. Since this is 
such a large work it will probably 
be better to order it and then pick 
up a copy from the nearest QL 
Show. 
| 
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The QL Show Agenda 


Za 
Sunday 16th August 1998 

9th Great Eastern Radio and Computer Rally 

Doors open 10.00 am. The venue is Wallington Hall. 

Located between King’s Lynn & Downham Market, Norfolk. Approx 5 miles South of 

King’s Lynn on the A 10. 

Quanta, TF Services, Quobesoft, Q Branch, W.N. Richardson attending! 


Saturday, 5th of Sept. 1998: Eindhoven - regular meeting 
As usual, between 10am and 4pm, in the St. Joris College in Eindhoven. 


Sunday, 4th of October 1998: The BYFLEET WORKSHOP 
The show will be on between 9:30 and 5, in BYFLEET VILLAGE HALL. 
BYFLEET is just inside the M25, on A245. From M25 Jn 10 take A3 towards London | 
then A245 towards Woking, and turn left (south) into Byfleet at the first or second 
roundabout past the A318 junction. 

From M95 Jn 11 take A317 towards Weybridge then A318 to Brooklands/ Byfleet. NB 
A318 now goes through Brooklands racetrack. Turn right (west) at A245. 

Non-MQ5 is via A245 from west or east (or A3). 

The hall is on the (old) High Road, western end, just south of A245. It is about 12 
mins walk from Byfleet & New Haw station, on the main Waterloo - Woking line. 
Queries? Ken Bain (SQSG Sec) 01932 347 432, pre midnight, email keno@bcs.org.uk 


Sat. & Sunday, 10th and 11th of October 

International QL Show in Heidenreichstein, Austria (near the Czech border). 
The venue is the Gasthof-Restaurant Nobauer, A-3860 Heidenreichstein, Schremser 
StraBe 98 (Tel. 0043(0) 2862/59937 or 59746). A room the size of the one in 
Salzourg (after moving) is available. The Gasthof provides 22 rooms with 22 beds. 
You can also find other accommodation in the same town. 

As usual, there is also a "tourist" program for the visitors: a 1-2 hour ride on an 
old-fashion train (paid for by the Vienna QL user group), followed by a dinner with 
local specialities. On Sunday, it is possible to visit the moor and one of the best-kept 
water-castles. A visit to a local glass-manufacturer should be no problem. 


Saturday, 31st of October 1998: Eindhoven - International meeting 
Again, as usual, between 10 am and 4pm in the St. Joris College. We expect all 
dealers to come, and of course lots of international guests will be invited. 

Probably THE date on the continent for Autumn. 


Sunday, 8th of November 1998: Portishead (Bristol) Workshop. 
There is still plenty of time, therefore details will follow in the next issue. 


